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INTRODUCTION 


This manual describes ETOS (Extended Tape Operating System) the soft- 
ware environment provided for GE-120 and GE-130 Magnetic Tape oriented 
systems. Since this manual was originally developed for the CE-130, 
any reference to this system should be extended to the GE-120, except 
when some differences between the two systems are brought out. ‘The 
material is presented in five parts, as follows: 


Te General Description 


II. Tape and Program Organization 
This part describes the formats of the programs recorded on the 
three Program Tapes used by ETOS. 


III. ETOS Operation 
This part describes the components of ETOS (Supervisor and Order 
Programs) and the Parameter Cards prepared by the user to direct 
the operation of ETOS. 


Iv. Examples 

v. Appendixes 

The manual is written for use by Programmers, Analysts and Applications 
Engineers, A seperate manual, "ETOS Operator's Manual" is provided for 
the use of Operators. 

A comprehensive listing of prerequisite and related reading will be 


found in Appendix B. The reader will find this listing of value in 
relating this manual to the GE-120 and GE-130 system concepts. 
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PART I- GENERAL DESCRIPTION 


WHAT IS ETOS 


Definition 


ETOS is a comprehensive set of programs providing a software environment 
in which GE-120 and GE-130 tape-ortented systems can operate with maximum 
efficiency and reliability, and with minimum operator intervention. 

Basically it is used in two ways. 


° To translate source programs into machine language and debug 
the resultant object programs. This series of operations is 
executed in the System's starting phase and is repeated each 
time new applications are programmed, or where modifications 
are made to existing applications. 


To control the execution of user programs. 
ETOS offers many advantages to the user, including: 


. Automatic link-up between the different work phases, with minimum 
operator intervention and consequent errors. It is possible, for 
example, to compile a program, generate sample files, start 
the compiled program; and execute auxiliary operations such as 
file or store dumping, with no operator intervention when passing 
from phase to phase. This makes it possible to execute a whole 
series of programs without interruption, by first preparing the 
link-ups between the various programs. 


+ ‘Standardization of communications between programs and operator. 
For example, all programs print standard messages and halt at 
fixed addresses if errors or incidents should occur. This simplifies 
the operator's work considerably. 
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Independence from different models of main peripheral units 
(printers, card readers, etc.) which may be connected to the 
system. All I/O (input/Output) routines are stored in fixed 
locations and are supplied in different versions according to 
system configurations, As a result, a print, read, or site 
instruction normally will obtain the same result, regardless of 
the model of the peripheral unit used. 


The program designed for the GE~-115 TOS (Tape Operating System) 
may be run unchanged on the GE-120 or GE-130, under control of 
ETOS. This is done either by re-translating them, or by inserting 
them in machine language into GE-120 or GE-130 program tapes. 


2. Components 


ETOS programs can be divided into two main groups: 


a. 


The Supervisor. Located in Core Store during operation, it 
contains the following programs which are prerequisite for 
running any other system program: 


" Pilot 1 and Pilot 2 programs 
* BIOS (Basic Input/Output System) 
. Segment Load routine 


The Supervisor is described in Part I, starting on page 7. 


The Order Programs are selected by the user to direct the 
actual operation of the GE-130, from program translation and 
debugging to the execution of user programs and maintenance 
of the software library. The Order Programs are described in 
Part I, starting on page 22. 
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Related Software 


In addition to user programs, a number of general purpose programs 
are used, including: 


Translator Programs 
Utility Programs 
Standard and User Subroutines (S/R's) 


Translator Programs 
These include assemblers, compilers, and program generators 


which are used for converting or translating from source to object 
programs, 


APS (Assembly Programming System) is a symbolic, machine- 
oriented source language with essentially a one-to-one 
correspondence between source and machine (object) 

language. However, it also includes a group of macro~instructions 
for calling subroutines and EIOS (Extended Input/Output System). 
APS is fully described in the GE-120 and GE-130 Reference Manuals 
and the GE-120/130 APS Manual, both of which are listed in 
Appendix B of this book, 


COBOL (Common Business Oriented Language) is a symbolic, 
user-oriented language designed for accounting and administrative 
applications. Each COBOL program can be executed in computer 
systems that are different in their internal logic and machine 
language. COBOL is fully described in the COBOL Reference 
Manual, listed in Appendix B of this book. 


FORTRAN (Formula Translator) is a symbolic, user-oriented 
language designed for mathematical, technical and scientific 
applications. Each FORTRAN program can be executed in 
computer systems that are different in their internal logic 

and machine language. This language is fully described in the 
FORTRAN Reference Manual, listed in Appendix B of this book. 
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SPG (Sort Program Generator) produces optimal Sort and 
Merge program using simple, user-written SPG statements. 
This language is especially designed to describe data files to 
be sorted and/or merged. It is fully described in the SPG 
Reference Manual, listed in Appendix B of this book. 


Utility Programs 


These programs are designed to perform media conversion 
operations, 


Standard and User Subroutines 


Standard Subroutine include: 


EIOS. A set of $/R's designed for logical processing of files 

{as contrasted with physical processing performed by BIOS) 

on all types of input/output media. APS macro-instructions 

are used to call EIOS and decribes the data files to be processed. 
See the GE-120/130 APS Manual for a full description of EIOS. 


Additional S/R's for handling peripheral units that are not 
covered by EIOS or BIOS. 


User S/R's include an extensive S/R library developed by the 
manufacturer plus those developed by the user for his special needs. 


Major Block Diagram 


Figure 1 is designed to give a visual concept of the components of ETOS, 
and its related software. It is intended to illustrate the inter-relationships 
between functions and to show the general operational sequences of the 
system. 
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B. HOW TO USE ETOS 


L 


General Concepts 


ETOS operation is based on the use of three Program Tapes: 


System Tape (ST) 
Library Tape (LT) 
Master Tape (MT) 


One, two or three Work Tapes (WT), and the Order cards 


a. 


The sT 


This is the basic Program Tape, containing the complete 
software’system. The LT and MT are derived from it, either 
directly or indirectly. It is made up of: 


Supervisor 
Order Programs 
E Translator Programs 
. Subroutine Library 
. Utility Programs 
‘ User Programs 


The ST is used to compile and debug User Programs, When a 
program has been debugged it is normally transferred to the 
LT, but it may be started from the ST itself. 


The LT 
This tape contains all the User (and Utility) programs in working 


order., However, since it does not contain the ETOS program, it 
cannot be used for executing user programs. 
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The MT 


This tape contains all user and ETOS programs needed for operations 
during 2 specific working period (shift, day, week). The programs 
contained in this tape have been debugged and are arranged in proper 
sequence for carrying out the planned schedule of operations. 

They include: 


Required User (and Utility) programs 
(Those needed for the work period) 


Super visor 


ETOS programs (for initializing the system, loading and 
starting the user programs) 


Monitor programs (used for chaining each two user programs) 


However, additional ETOS programs may be inserted into the MT 
as desired by the user. 


The MT is generated by combining the required ETOS programs 
from the ST, with the required user (and utility) programs from the LT. 


The WT 


At least two Work Tapes (WT1 and WT2) are required in ETOS operation 
for storing data or program files. An optional WT3 may be included, 
as needed. 


Order Cards 


These are used to command the execution of desired ETOS programs, 
which are, thus called "Order Programs", The cards are punched and 
sequenced by the user as desired, to obtain specific results from the 
ETOS programs. 
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Applications 


ETOS programs may be called up by the Order cards in any or all of the 
functional phases of the GE-120/130 systems, as follows: 


Program Translation 
Program Debugging 
Program Storage and Maintenance 


Program Execution 
Program Translation 


APS, COBOL and FORTRAN programs are translated into machine 
language in a single processing run. SPG requires two runs: 


é To obtain the program in APS 


To translate the program into machine language 


The two runs are linked automatically, without operator 
intervention. 


In the translation process, S/R's can be assembled to the main 
uger program, S/R calling is implicit in some source language 
statements, or may be carried out by the "SUB" statement. 
Program, Debugging 


ETOS provides a number of very helpful facilities for program 
debugging. For example: 


. Recording sample files on tape before user program atart-up. 
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Presetting user programs for execution with Path Trace Printing” 
(printing out all jump instructions that have actually occurred). 


Presetting user programs for "controlled execution". This is done 
by inserting machine language corrections from punched cards into 
the translated program, and by presetting some points in the program 
where printout of significant Core Store areas is desired (Memory 
Trace Printing). 


Interrupting the debugging at any desired point to perform various 
checks such as "Tape Dump" and "Memory Dump". 


Program Storage and Maintenance 


After debugging, the program is corrected (if necessary) in symbolic 
language, retranslated, and finally inserted in an appropriate file with 

all other debugged programs of the system. This file, the Library Tape (LT), 
is used as a "file collector" of completed, debugged, user programs. 


Program Execution 


In normal system operation ETOS provides many aids. After the programs 
to be executed have been selected and arranged in proper sequence, link-up 
procedures between programs (the Monitors) are prepared, and operator 
intervention points are established. 


When these decisions have been made by the programmer, the programs 
are collected by ETOS in a specific object-program tape (the Master Tape, 
or MT) and the Monitors are inserted. Depending on the user's initial 
decisions, the Monitor automatically loads and starts the next program. 
The operator intervenes only at pre-established points: to mount new tapes, 
change printer paper, or to modify the order of execution of the program. 
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3. Hardware Configurations 
ETOS requires the following minimum system configuration: 


16K Core Store 

‘ Any one Card Reader or Card Reader/Punch 
Any one Printer 

5 Four Magnetic Tape Units 


4. Core Store Allocations 
In using ETOS, Core Store is divided into two areas: 


System Reserved Area (SRA) 
User Reserved Area (URA) 


The SRA requires approximately 2400 octets of storage and includes: 
. Supervisor 
Data required by user programs. 


Data required by Order programs. 


HLT instructions (where programs stop as a result of condition 
checking). 


Instructions for calling EIOS and other standard routines, 
SRA is described in detail in Appendix C. 


The URA is available for user programs and will vary according to 
the total Core Store capacity. 
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PART I. - TAPE AND PROGRAM ORGANIZATION 


1. GENERAL CONCEPTS 


This part deals with the organization and formats of programs on the 
ST, LT and MT. 


NOTES: a. ST, MT, and LT tapes are generated by the appropriate 
Order programs. 


b. The three tapes may be either 7- or 9-track. 
ec. Only characters of the GE-100 character set are recorded. 


d. There are three types of programs, as follows: 


Description 


ETOS Programs and Translators 
Subroutines 
User and Utility Programs 


e. Many terms used in the following descriptions are abbreviated 
for the sake of simplification, If the reader wishes to refresh 
his memory, refer to Appendix A, "Glossary of Terms", or 
to the Index of Terms. 
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2. SYSTEM TAPE (ST) 


The organization of programs on the ST can be visualized as follows: 


ETICHETTA EFICHETTA ™ 
WHIZIO WASTRO WNIZIO FRUSSO 

TIPO 

PROGRAMMA 


Gee Peed] Toma men 
mee EEL ee Oe 
ee | 


FIGURA 2~ ORGANIZZAZIONE O&L ST & OFL MT 


NOTES: 1) Program Tape Header Labels are the same as for standard 
Data Tapes, and are identified as follows: 
VOLI for 9-track tape labels, or 
INT1 for 7-track tape labels 
HRD1 for file labels 
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2) The Program Tape Trailer Label consists of 28 characters, of which 
the first nine are exclamation marks (!). 


Type 1 and Type 3 programs have similar formats, and are described together. 
Type 2 programs are described separately. 


a. Type 1 and Type 3 Programs 


The label of each program is 28 characters long, formatted as follows: 


ToT 6 7 72h 24 25, 28 


cHan “YZ 


FIGURE 3 - TYPES ] AND 3 PROGRAM LABEL FORMAT 


ETOS and User and Utility 
Translator Programa Programs Notes 


A Program Type 
B Program Name Same as Type 1 Alphameric 
Cc O,. if GE-115 BIOS, C, if program Indicate type 
no tape routine generated by of BIOS 
1, if GE-115 BIOs,, .DPG order and 
with tape routine uses GE-130 
4, if GE-130 BIOS, BIOS. 
no tape routine Otherwise, same 
5, if GE-130 BIOS, as for Type 1 
with tape routine programs 
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a3 ETOS and User and Utility 
Translator Programs are 


¥YYDDD 


BYYDDD 


Not significant Starting address 
(in unpacked 
binary) of File 
Table in Core 
Store, if any. 
Otherwise, all 
zeros. 


Program starting 
address (in 
unpacked binary) 


Same as Type 1 


Address (in unpacked 
binary) of first store 
location not used by 

program. 


Same and Type 1 


Each program contains one or more segments, each of which contains 
one or more blocks. Each block has a label of 20 characters, formatted 
as follows: 


FIGURE 4 -~TYPES 1 AND 3 PROGRAM BLOCK LABEL FORMAT 


TI-4 


NOTES: 5) 


2) 


3) 


4) 


5) 


Field Contents 


A ??, if block is the last in segment. 
00, if not the last. 


Number (in unpacked decimal) of segment to which 
block belongs. 


Block length, minus 1 (in unpacked binary). 


Initial address of block in Core Store (in unpacked 
binary). 


Not significant, 
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The segments within a program are numbered 
sequentially from 01 to 98 (Field B). 


Block lengths have the following limitations: 
minimum - 20 characters 
maximum ~-4096 characters 


The Supervisor is the first Type 1 program. Its 
format differs from other programs in that: 

It uses no block labels 
. It is always eight blocks long. 
The program name (Field B, figure 3, Page II-3) 
for the Supervisor is BASICPRG. 


In Type 3 programs the File Table, if present, occupies 
the first block of the first segment. The last character 
in the File Table is an exclamation mark(!). 


Type 3 programs generated by the . DPG Order (for 
controlled execution) are always recorded after the normal 
Type 3 programs. 
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b. Type 2 Programs (S/R Library) 


Figures 5 and 6 illustrate the structure of the Type 2 programs. 


LOCH 
ok 


FIGURE 5- TYPE 2 PROGRAM LIBRARY FORMAT 


ci 
1 6 7 8 3 
a | 73 20 a i 
D3 E, bo, VARIABLE 
2 334 35 40 4 
a a7 48 49 aS 


FIGURE & - TYPE 2 PROGRAM BLOCK LABEL FORMAT 
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Contents 


Subroutine (S/R) Name. 


B Number of S/R's called (maximum 6). 
Cc Date $/R inserted in Library (BYYDDD). 
D Name of S/R called, if any. 

1-6 


Sequence number of S/R called, if any. 


NOTES: 1) The S/R Library label uses only fields A and B of . 
the Type 1 and Type 3 program labels on ST (see 
figure 3, page II-3) as follows: 

Field A = 2 (type of program) 
Field B = BASICSUB (S/R Library Name) 
Fields C through G are blank characters. 


2) Each S/R may occupy one or more blocks. 


3) Each block in the S/R Library consists of: 

. Block label, 
Four characters, containing length (in unpacked 
binary) of the S/R portion (assumed to be in packed 
form) contained in the block, 

. Four characters containing initial address (in 
unpacked binary) of block in Core Store. 

. Part or all of a S/R. 


3, 


4) 


5) 


8) 


” 


8) 


9) 


10) 
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Block lengths may be up to 1200 characters, 


Each block is followed by either: 


E ~ ff block is the last of the S/R, or 
R - ff block is not the last of the S/R 


S/R's are not preceded by labels since the identification is 
contained in each block label. 


Each S/R may call up to six S/R's, numbered 1 to 6 
{Field B, figure 6, page I-6). 


The S/R sequence number (Field B, figure 6) is used to call 
the desired S/R. 


Block label lengths: 
Minimum (No S/R's called) = 13 characters 
Maximum (6 S/R's called) = 55 characters 


S/R's are recorded in machine language and start from 
address zero. S/R addresses are converted into actual Core 
Store addresses at assembly time. 


LIBRARY TAPE (LT) 


The LT contains the Type 8 (User and Utility) program in working 


. order; that is, those that have been properly debugged and with 


all related S/R's incorporated The organization of programs on 
the LT can be visualized as follows: 
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TAPE HEADER FILE HEADI 
Th ER |r 


TS [ae | ae ote [ee Ie 


FIGURE 7 - ORGANIZATION OF LT 


NOTES: 1) ‘The organization and format of programs on the LT is the 
same as on the ST (figure 2, 3, and 4) except that there 
ave no Tape Mark (TM) separations between each two 
programs. 


2) Programe for controlled execution (generated by .DPG 
Order program) are not transferred from ST to LT. 


4. MASTER TAPE (MP) 


The MI contains all Type 3 programs in proper sequence and ready 
for execution during a user-defined work schedule, plus the Type 4 
programe required to execute them, The MI format is the same as 
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the ST format (figures 2, 3, and 4). The following figure 
illustrates the arrangement of Type 1 and Type 3 programs in the 


™, 
ORDER OROER 
SUPERVISOR Led | INT rogram \ Ted PROGRAM {7 
TYPE T 
PROGRAMS 
ORDER ORDER ORDER ORDER ly, 
paosray |") procrase pet it prosrare [TM |+PRL paceeam [OF 
[ee ae ee oe 
TYPE 3 
PROGRAMS 
an [om I 
NOTES: 1) The Supervisor, the .INT and .PRL Order programs are 


inserted automatically in the MP when it is generated, 
and in the order show. 


2) any additional Type 1 program may be inserted as needed 
> by the user, before the .PRL Order programs 


Reve Nove 1969 
II-10 
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Segments 00 and 99 are automatically inserted before and 
after each Type 3 program, during MT Generation. Segment 
00 contains the appropriate BIOS routines for that program 
and some optional routines to preset the program for 
execution. The Monitor is in segment 99. I+ is used to 
load and start the next program to be executed, Its format 
is show in figure 9 


Contents 


Monitor Routing Code (may be 1 through 5). 
Note: the uses of Routing Code are described on Page III, 18 


Name of program to be loaded: 
if Field A= 1, or 
if Field A = 2 and Switch 2 is off. 


Name of program to be loaded: 
af Field A = 2 and Switch 2 is one 


Not significant 
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Address relative to beginning of the following list 
(Field F) where name of current program is found. 


Fc 
E 
Pr 


List of names of Typa 3 programs preceding this Monitor. 
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PART Il - ETOS OPERATION 


The following pages describe the ETOS programs, and how the user controls 
them. 


ETOS operation is under the control of either the ST or the MT, as desired by 
the user. Thus, two modes of operation may be defined: 


System Tape Mode (STM) 
Master Tape Mode (MTM) 


The differences between the two modes are due to variations in Type 1 programs; 
principally in the Supervisor. Therefore, the description of the Supervisor includes 
a discussion of the STM and MTM (see page III-16) 


A. USER CONTROL OF ETOS 


The system is initialized by a punched card containing the program, 
Pilot 0, The operation of the system is controlled by Order programs. 
The parameters of the Order programs are determined by the user, 
according to his specific needs, 


1. Parameter Cards for Order Programs 


This chapter gives a general description of Parameter cards, their 
purpose and applications. How they are processed by the Supervisor 

is described in Part II, starting on page 10. The types of Parameter 
cards (Order, Detail, and End) are described in the following paragraphs, 
Their uses in individual Order programs is described in Part I, starting 
on page 22. 
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To obtain service from ETOS the user formulates suitable commands that are 
communicated to the system by selected Parameter cards. For example, if 
an APS program on cards is to be assembled, the command is transmitted by 
an Order card, followed by the source program deck. 


After ETOS has executed a given command it seeks another Order card. Thus 
it can execute a series of programs without interruption, allowing the user to 
plan his work schedule by preparing a series of Parameter cards. 


The Parameter cards for each Order program are used in the following 
sequence: 


One Order card, always present. 
One or more Detail cards, where applicable. 
One End card, where applicable. 


a. Order Cards 


The general format of these cards is illustrated as follows: 


AIGURE 10 ~ BASIC FORMAT OF ORDER CARDS 
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The fixed character ". " (period), 


Order name, expressed in mnemonic form. 


Order information, Contents will vary depending 
on individual Order, 


ID Sequence Code if applicable. 


Always blank. 


b. Detail Cards 


The first four columns are punched /XXX. The symbol "}" represents 
a blank and "XXX" represents the mnemonic name of the card, The rest 
of the card is formatted in accordance with the specific Order. 


ce. End-of-Order Cards (End Cards) 


These always contain a card name (SEND) in the first four columns. 
The rest of the card is either blank or formatted in accordance with the 
Specific Order. End cards are always required when Detail Cards are 
present, or when optional but not used. 


d. ID Sequence Code 
This is commonly referred to as the "ID Code" (Field D, figure 10). 


When present, it is used to identify a sequence of Order cards which 
are being used to perform a series of inter-related operations. 
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When used, the ID Code provides the following checks: 


1) An Order card is processed by ETOS, only if the previous 
Order card in the same sequence was successfully processed. 
Any intermediate Order cards with no ID Code ¢o not interrupt 
the sequence. 


2) If an Order card is initiating a new sequence, or if it has no ID 
Code, it is processed regardless of the correct or incorrect 
execution of the previous Order, 


NOTE: The ID Sequence Validity Switch is tested for the correct or 
incorrect execution of a program. This is an octet in SRA which 
sets to: 

'YES' (hexadecimal 00) if the program was correctly 
executed. 

‘NO! (hexadecimal 01) if an error occurs, 

The ID Switch can be set by both Type 1 and 3 programs. 


e. Examples of Use of Parameter Cards 
Problem 1 
A program written in APS is to be translated, loaded and started. 
Each Order to be executed only if previous one was carried out 


successfully, 


Solution: Use following sequence of Parameter cards, with same 
ID Code (AAAI), 


Operation Description Parameter Cards 


Translate APS program . APS Order card 


Introduce APS source (source program 
program. deck) 
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Insert assembled program | .API Ordercard 
in ST 


Generate Sample File .SGE Order card 


Introduce information Detail cards 
to be recorded on tape 


End of .SGE Order End card 


Load and start program . PRL Order card 


Update File Table, if LBC Detail cards 
applicable 


End of . PRL Order End card 


Problem 2 


Same as Problem 1, plus print the file recorded by the Sample 
Generate operation, in order to check it, (This operation should 
be done regardless of the results of the previous operation). 


Solution: Use the same series of Parameter cards as in Problem 1, 
but insert a . TDP (Tape Dump) Order card with no ID code, before 
step 6, 


Problem 3 

After executing Problem 2, start a new sequence to assemble a 
new program and insert it in the ST. The second sequence is 
completely independent of the first, therefore requires a different 
ID code (BBBB). 


Solution: Use the following sequence of Parameter cards: 
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Translate APS program 


Introduce APS source 
program 


Insert assembled program 
inst 


Generate Sample File 


Introduce information to 
be recorded on tape 


End of . SGE Order 
Print contents of tape 
Load and start program 


Update File Table, if 
applicable 


End of . PRL Order 


Translate APS program 


Introduce APS source 
program 


Insert assembled program 
in st 
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. APS Order card 


(source program deck) 


-API Order card 


. SGE Order card 


Detail cards 


End card 
- TDP Order card 
- PRL Order card 


LBC Detail cards 


End card 
- APS Order card 


(source program deck) 


. API Order card 


BEE 


BBBE 


BBEB 
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Pilot 0 


This program is punched in a single card and is read into Core 
Store by normal manual initialization procedures. It searches the 
ST or MP for the first block of the Supervisor, called Pilot 1, 
thus starting ETOS. 


Pilot 0 is essentially a fixed program, the only variable 
parameter being the name of the tape unit on which the ST or MT is 
mounted. It is stored permanently in the first 40 octets of SRA. 
The format of the Pilot 0 card is show in the ETOS Operator's 
Manual, page III-9. 


ay Restarting Pilot 0 


During processing, Pilot 0 is restarted as follows: 


1) After executing any program, a STOP macro-instruction 
causes a jump to the field in SRA (hexa.address 0248) 
which resets the initial tape density and parity 
conditions. Then, if operating in STM (page III-16) 
Pilot 0 is restartedj if operating in MIM (page III-16), 
the Monitor io started. 

2) If an error occurs during execution of a Type 1 or 3 
program, the use of an ABORT macro-instruction causes 
a jump to the field in SRA which sets the ID switch to 
NO. The program then stops at address 0246, By 
pressing START, Pilot 0 is restarted. 


SUPERYISOR 


This section contains a description of the Supervisor and its 
operation, as follows: 
» Purpose and organization. 


» Operation of Supervisor programs (Pilot 1, Pilot 2, Segment 
Load routine, BIOS). 
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. Condition checking during Supervisor operation. (See "GE-130 
ETOS Operator’s Manual" for details on operator actions). 


The section also includes a description of Supervisor and System 
operation in STM and MIM. 


1. Purpose and Organizat ion 


The Supervisor is the controlling part of ETOS, since it links the 
various phases of work, performs the physical Input/Output 
operations, and processes the Order programs. It is recorded in 
the ST and MT as the first Type 1 program, and consists of eight 
unlabelled blocks as shown below: 


SUPERVISOR LABEL BLOCK + Block 2 

[rescore | | Por t IDATA AND SERVICE AREAS 

9 28 
at 
ALock 3 BLOCK 4 Block 5 “ 
GE-HS BIOS MEMORY DUMP SEGMENT LOAD ROUTINE 
READ ANO PRINT ROUTINES ROUTINE Jato Ges B10 tare RourinE 
ane | 

BLOCK & BLOCK 7 BLock 8 


€£-130 Bios | ée~ 10 Bus | 


FIGURE 11 - FORMAT OF SUPERVISOR on ST AND MT 
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Block 1: Pilot 1 is used to read and check the Order cards, and to 
start Pilot 2. 
Block 2: The Data and Service areas consist of: 


All data describing the specific system configuration. 
ETOS service area. 

. Card read area. 

- Print area. 

This block is stored in the SRA during ETOS operation. 


Block 3: The GE-115 BIOS Read and Print Routines are variable, 
depending on the models of the Card Readers and Printers being used. 
This block is stored in the SRA whenever the use of 115 BIOS is specified 
in field C of the labels (see page I[-3) of Type 1 or 3 programs. 


Block 4: Is called into Core Store by Pilot I to execute a Memory Dump 
when the . MDP Order Card is read. 


Block 5: The segment Load Routine searches for loads, and starts the 
first program segment. The 115 BIOS Tape Routine performs all physical 
I/O operations on Magnetic tapes. 

This BIOS is stored in SRA whenever its use in specified in field C of the 
labels (see page I-3) of Type 1 or 3 programs. 


Block 6: Pilot 2 starts a given program. It also introduces GE-120/130 
BIOS into the SRA, when specified in field C of Type 1 or 3 program label. 


Blocks 7 and 8: The 120/130 BIOS routines (where applicable) replace the 


115 BIOS routines in the SRA, under control of Pilot 2 or the . PRL Order 
program. 
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Pilot 1 
Pilot 1 is loaded in SRA and started by Pilot 0. 
a. Reads Blocks 2 and 3 of the Supervisor into SRA. 


b. Reads and processes Order cards as follows (see Flow Chart, 
fig. 12): 


1) Read a card 


2) Check to see that it is an Order card (valid card name in first 
four columns). 


3) If not, go back to 1). 


4) If an Order card, print five asterisks, today's date, and the 
contents of the Order card. (if a.CMT Order card, only print 
the associated comments). 


5) The ID Code is examined. 
6) Ifno ID Code, go to 15). 


7) if the ID Code is punched, check to see if it is the first Order 
card, 


8) If first Order card, move ID Code to ID Code Store Area in 
SRA, then go to 12). 


9) If not first Order card, compare ID Code to ID Code Store 
Area. 


10) If ID Codes equal, test the ID Switch in SRA (See page Ii!-4), 
then go to 13). 

11) If ID Codes are different, move the new ID Code to ID Code 
Store Area. 

12) Set ID Switch to YES, then go to 15). 

13) If ID Switch set to NO, print 0196 * ORDER NOT EXECUTED 


and go back to 1). 
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ORDER 
CARD 
g 
‘PRESENT IN CARD 
a 


ID 
CODE IN 
card = To ID 
AREA? 


Move ID CODE 
TO 1D AREA 


1D 
SEQUENCE 
VALIDITY 

S' WITCH 


ser ID 
SEQUENCE VALIDITY 
SWITCH TO YES 


ORDER PROGRAM 
EXECUTION 


‘PROGRAM 

SUCCESSFULLY 

COMPLETED, 
2 


skT ID 
SEQUENCE VALIDITY 
SWITCH TO NO 


FIGURE 12> ORDER PROGRAM FLOWCHART 
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Hf DD Switch set to YES, go to 15). 


If the Order is .CMT, go to 1); of the Prder is .HLT stop at 
address 01D6 (by pressing START, Pilot O can be restarted). 


Read Block 4 of Supervisor (Mernory dump Routine) in SRA. 
If the Order is . MDP, this program is executed, then go back to 1). 


If the Order is not .MDP 


. Read and store Block 5 (Segment Load and 115 BIOS 
Tape routines) in SRA. 
. Read and store Block 6 (Pilot 2) outside SRA. 


Start Pilot 2. 


NOTE: Pilot 1 is destroyed at the end of its execution. 


Pilot 2 


Pilot 2 operates in the following sequence: 


a 


ce 


Enter the ST or MT Select number in the Segment Load routine 
and location 0080 in SRA, then generate in SRA the PER instructions 
that reset the tape parity and density conditions. 


Record blocks 7 and 8 (120/130 BIOS) outside SRA. 
If the Order is . PRL, set the ID Switch to YES (a . PRL card with 


no or with different ID Code always interrupts a sequence of Order 
cards), 
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Search ST or MT for the Order program to be executed, If this 
search fails, print the message: 


0297* ORDER UNKNOWN 


and stop at address 02A6. 
(By pressing START, Pilot 0 can be restarted). 


¥f the Order program is found, print the program creation 
date (recorded in the program Label). 


If required, replace the 115 BIOS with the 120/180 BIOS in SRA, 
If the Order is not . PRL, set URA to hexadecimal "0A". 
Enter the program initial address in the Segment Load routine. 


Start the Segment Load routine. 


Segment Load Routine 


The Segment Load routine searches the ST (or MT) for a program 
segment, loads it into Core Store and starts it. 


This search is carried out by reading the segment numbers in program 
block labels, as follows: 


a 


b. 


Segment number fod. The segment is loaded and started. 


Segment number less than requested. Reading of block labels 
continues until either the required segment of the end-of-program 
TM is found. When reading a TM, the tape is rewound to the 
beginning-of-program TM, and the tape is searched forward again. 
if the required segment is not found, the tape stops at the end-of- 
program TM; the ID Switch is set to NO and processing stops at 
address 0200. 


Segment number greater than requested. The routine rewinds the 
tape to the beginning-of-program TM and searches the tape forward, 
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If the required segment is not found, the tape stops at the end-of-program 
TM; the ID Switch is set to NO, and processing stops at address 0200. 


d. End-of-program TM is read. The routine proceeds as in case c. ° 


Execution of Order Programs 


An Order program is executed on the basis of the parameters punched in 
the Order card and in the associated Detail cards, if any. 


At the end of an Order program, control is transferred either: 


a, Toauser program, if the Order program was . PRL, or 

b. To the Supervisor (which reads and processes the next Order). 
During the execution of a user or Order program, the ID Switch may 
be set to NO as a result of some error condition, and control is 


transferred to the Supervisor, 


Basic Input/Output System (BIOS) 


a. General Concepts 


BIOS is a set of routines for the physical processing of recorda 
on I/O media, such as the reading of a card or of a block on 
magnetic tape. BIOS is stored in SRA during system operation. 


BIOS can be called by the APS source program, either directly 
(using BIOS macro-instructions) or indirectly (using EIOS 
macro-instructions). The BIOS macro-instructions are listed 
in paragraph ec. below, while EIOS macro-instructions are 
described in the GE-120/GE-130 APS Manual, 
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Types of BIOS 


The BIOS to be used under ETOS varies according to system configuration, 
as follows: 


+ » 120/130 BIOS, with read/print routines 
+ 120/130 BIOS, with read/print/tape routines 
115 BIOS, with read/print routines (see Note) 
115 BIOS, with read/print/tape routines (see Note) 


The type of BIOS required by each program is specified in the tenth 
character of the Type 1 or 3 Program Labels (fig. 3, page H-3). 


In the case of Type 3 Programs on MT, the specified BIOS routines 
are incorporated into segment 00 of the program during MT generation 
(see . MTG Order). They are then transferred to SRA before program 
execution. 


In the case of Type 1 Programs (either on ST or MT) or of Type 3 Programs 
(on ST only), the specified BIOS routines to be used in SRA are selected 
by the Supervisor, and loaded from ST {or MT), as required. 


NOTE: The 115 BIOS may be used by the Type 1 programs and by those 


Type 8: Programs which were written for the GE-115 but not 
translated by the GE-120/130 Translator Programs. 


BIOS Macro-Instructions 
These are of two different types: 
. Command, for the actual execution of I/O operations. 


Validation, for auxiliary operations, such as error checking, 
end-of-file detection, out-of-order checking. 
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The BIOS macro-instructions are listed below: 


*READ = Read acard 

#VCR = Validate Card Reading 

* PRINT = Print a line and/or advances paper on Printer 

*VPR = Validate Printout 

*LBSS = Read and Print 

*MTAPE = Operate Magnetic Tape Unit (read, write, 
erase or rewind) 

+VMT = Validate Tape Operation (data transfer) 

*TAPE = Operate Magnetic Tape Unit and Validate 


Operation 
7. System Tape Mode (STM) 
In STM all Order programs can be executed, since ST contains 
all of them. Type 3 programs can also be executed, but without 
programmed chaingin between programs (control is transferred 
to the Supervisor at the end of each program). 
8. Master Tape Mode (MTM) 


a. General Concepts 


The MTM is the common user mode, as it provides for the 
normal execution of user programs, 


In this mode, after the execution of each user program, control 


is transferred to its Monitor, which searches for, loads and 
starts the next program, 
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The Supervisor, .INT, and . PRL programs on the MT differ from 
the same programs on the ST in the following respects: 


1) ‘Supervisor 


a) In MTM, before reading an Order card, Piloti 
checks the contents of the MT Control Area in SRA, 


b) If the MT Control Area is set to hexa. 00, another 
Order card is read and processed by Pilot 1 as 
described in steps 1 to 19 starting on page IiI-10. 


¢) if the MT Control Area is set to 01, an Order card 
was previously read by the Monitor of the preceding 
program into SRA. The MT Control Area is reset to 
00, and the Order card stored in SRA is processed 
by Pilot 1. 


2) .INT 
In this program, all references to ST are changed to MT. 

8) . PRL 
In MTM, before starting a user program, the . PRL program 
substitutes in the Re-entry Jump Area in SRA, the address of 
the Monitor of that User program, (In STM, the address of 
Pilot 0). Thus after executing a user program, control is 
transferred to the Monitor belonging to that program. 

Monitor 

The Monitor is created and inserted in the MT after each Type 3 


program at MT Generation time (see . MTG Order). The Monitor 
format on tape is illustrated in fig. 9, page I[-11, 
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After each Type 3 Program execution, the Monitor first checks 

the ID Switch. If it is set to NO, Pilot 0 is started, thus transferring 
control to the Supervisor. In any case, if the Routing Code in the 
first character of the Monitor is 4, the Master Tape Stop Order 

(. MTS Order) is executed. 


If the Switch is set to YES, the Monitor prints the message 
2299 * END OF PROGRAM X 


then takes one of the following five courses, according to the 
Routing Code, 


Routing « 7 
Code Monitor Operation 


1 Print the message 

2281*NEXT PROGRAM IS X 

('X' was specified by the . MTG Order) 

Then search for, load and start the indicated program. 


2 Print the message 

2282 NEXT PROGRAM IS X WITH SWITCH 2 OFF/ 
Y WITH SWITCH 2 ON 

{'X' and 'Y' were specified by the . MTG Order) 

and stop at address 01D8. 

The Operator sets SWITCH 2 as desired then presses 

START. 

The Monitor stops again at address 01D8 to enable the 

Operator to reset SWITCH 2. 

After pressing START, the program specified in the 

message, is loaded and started. 


3 Print the message 

2283* NEXT PROGRAM SELECTED BY ORDER CARD 
Read an Order card. If it is not. PRL, start the 
Supervisor. If it is a. PRL card, the Monitor loads 
and starts the program specified by the . PRL card. 
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Execute the . MTS program, namely: rewind MT, print 
message 


2284* MASTER TAPE STOP 
and stop at address 01D6. 
To restart Pilot 0, press START. 


Print the message 

2285 * NEXT PROGRAM X SELECTED BY ENDED PROGRAM 
Search for, load and start the program, the name of which 
was placed in the Read Area of SRA by the program just ended. 


NOTES: 1) The Type 3 program seek time is reduced to a minimum 
by the use of the list of program names recorded in 
the Monitor (see Field F, figure 9, page I-11). 
In fact, if the program to be started is in that list, the 
Monitor searches the tape backward. Otherwise, it 
executes a forward search. 


re) 2) A complete list of the Monitor messages is included 
in the . PRL Condition Checking Messages (Program 
Load from MT and Monitor}, page M1-50. 


9. Supervisor Condition Checking 


During execution of the Supervisor programs various condition checks are 
executed and corresponding messages may be printed out and/or the programs 
9 stopped at specific Core Store addresses. 
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TITLE and NOTES 


Stops at 
address 


During Pilot 1 Operation: 
*ORDER NOT EXECUTED 
ID Switch set to NO. 
Pilot 1 looks for another Order card. 


During Pilot 2 Operation: 


*UNIT X: PERSISTENT ERROR 
Pilot 2 rewinds ST (or MT) and 
stops at address 
By pressing START, Pilot 0 is 


restarted. 


*UNIT X: OUT OF ORDER 
Pilot 2 stops at address 
By pressing START, Pilot 0 is 
restarted. 


+ORDER UNKNOWN 
Program specified by Order card not 
found on ST (or MT). 
Pilot 2 stops at address 
By pressing START, Pilot 0 is 
restarted. 
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b. The Supervisor program may stop at one of the following HLT 
instructions: 


0200 


02CA 


Reason for Stop Operator's Action 


Persistent tape read error 
(during Pilot 1 operation) 


Unit out of Order 
(during Pilot 1 operation) 


Pilot 1 is stopped by .HLT 
Order. 


Reason for Halt specified 
in message (see 'a! 

preceding}. ID Switch set 
to NO. 


Load Routine. 
ID Switch set to NO. 


Persistent tape read error 
during execution of Segment 
Load Routine. 

ID Switch set to NO. 
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Segment not found by Segment 


Press START to make 
five more read attempts. 


To restart Pilot 0, press 
OPERATE and START. 


To read another Order 
card, press START. 


To restart Pilot 0, press 
START. 


To restart Pilot 0, press 
START. 


To restart Pilot 0, press 
START. 
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INDIVIDUAL ORDER PROGRAMS 


The following pages give detailed descriptions of each Order. They 
are divided into five groups according to purpose, summarized as 


follows: 


Group 1. 


Group 2. 


Group 3. 


INITIALIZE Orders 
These are used to prepare the system for operation, 


TRANSLATE AND GO Orders 
These call out the proper pregrams for: 


Translating symbolic language programs into machine 
language. 


Inserting the translated programs into the ST. 
Starting the translated programs. 
Punching object programs on cards. 


DEBUGGING Orders 
These are used to: 


Set up a program for debugging. 
Generate sample files. 

Print the contents of a tape. 
Print the contents of Core Store. 
Duplicate tapes. 


List cards, 
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Group 4. PROGRAM TAPE GENERATE AND MAINTAIN Orders 


These are used to generate, modify, and update the ST, 
LT, and MT, 


Group 5. OTHER Orders 
These call for miscellaneous service functions. 


Each Order is normally described in the following sequence: 
Purpose and Operations 


Parameter Cards, describing type, format and sequence of the Order, 
Detail, and End cards used. 


Condition Checking Messages, listing a11 possible messages that 
may be printed out during the execution of the Order to notify 

the operator of the occurrence of some specific condition. When 

@ condition stops the program, the address of the HLT instruction 
is displayed on the CPU console, and the proper message is printed- 
out. For details of the corrective actions to be taken after each 
ELT instruction, see the ETOS Operator's Manual, listed in 
Appendix B of this book. 


Example, showing a typical application of the Order. 
« All abbreviations and special terms are defined in 


Appendix A, "Glossary of Terms", or in Appendix 0, 
"SRA Chart". 


. Tape units required for the individual Orders are 
specified in Appendix F. 
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1. INITIALIZATION ORDERS 


a INT Initialize 


1) 


Purpose and Operation 


The program called by this Order performs the initial 
operations to start the system, as follows: 


a) MM? Control Area and ID Sequence Validity Switch are 


Bet to binary zero. 
b) ED Code Store Area is set to }. 
c) The Day's date is loaded in SRA, 


a) ‘The USDA is loaded with the data’ punched’in Order 
card cols, 39 = 70, if requested. 


e) $f? (or MT) and WE Unit Select numbers (1 - 8) are 
printed. 


f) The numbers of the tape units containing WT's are 


loaded in Work Tape Unit Number area. (If WT} is not 


used, location 0083 is set to hexadecimal FF). 


The program also performs checks on the status of the tape 


unite, as listed in Condition Cheoing Messages. 
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2) Parameter Cards 


The program uses a single Order card, formatted as follows: 


= 


1-4 -INT 


5-10 Today's date (/YYDDD) 


11-16 Serial number of ST or MT if checking requested 
* in col. 11 if not requested. 


7 Tape Unit number on which WT1 is mounted, 
18 - 23 Serial number of WT1, if checking requested. 
* in col, 18 if rewind only. 
+ in col. 18 if no operation. 


24 Tape Unit number on which WTS is mounted, if used. 
¥ if not used. 


32 - 37 Same as cols, 18 - 23, but for WT3, if used, 
¥ if not used. 


38 User Data Code: 
*if data to be loaded in USDA. 
Kit not. 
39 -70 Contains data to be loaded in USDA, if requested. 


71 - 80 Not used (ID Code not significant). 
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3) Condition Checking Messages 


Number 


TITLE and NOTES 


*UNIT X: PERSISTENT ERROR (in reading) 
if serial number check is requested 


4UNIT X: OUT OF ORDER 
If after rewind command 
If after read command 

If during final rewind, program ends 
normally. 


*UNIT X: SERIAL NUMBER Y WRONG/ 
SHOULD BE N 


*INVALD DATE (cols. 5-10) 
*USER DATA CODE WRONG (col. 38) 


*UNIT NUMBER OF WT (1, 2, or 3) WRONG 
(cols, 17, 24, or 31) 


*SYSTEM (or MASTER) TAPE AND WORK 
TAPE (1,2, or 3) WITH SAME UNIT NUMBER 


* WORK TAPE X AND WORK TAPE Y¥ WITH 
SAME UNIT NUMBER 
UNITS OUT OF ORDER OR NOT SELECTED/ 


START 
*UNITS OUT OF ORDER OR NOT SELECTED/ 


IMPOSSIBLE TO PROCEED 
* TAPE ERROR/IMPOSSIBLE TO PROCEED 
Printed after Message 1001 or 1002 


* SERIAL NUMBER WRONG/IMPOSSIBLE TO 
PROCEED 
Printed after message 1010 
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*TAPE ERROR AND SERIAL NUMBER 
WRONG/IMPOSSIBLE TO PROCEED 
Follows the messages 1001 or 1002, 
and 1010, 


* SYSTEM (or MASTER) TAPE: UNIT X 
Designates unit on which tape is 
mounted. 


*WORK TAPE 1: UNIT X 
WT1 is mounted on Unit XK. 


*WORK TAPE 2: UNIT X 
WT2 is mounted on Unit X 


. *WORK TAPE 3: UNIT X 
WTS not being used. 


*IMPOSSIBLE TO PROCEED/LOAD PILOT 0 
Printed after one of following messages: 
1029, 1031, 1050, 1051, or 1052, 


* END OF INITIALIZE 
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4) Example 


. Problem: To initialize the system. 
Date: Year, 1968; day 162 
ST Serial Number: A10012 
WT on Tape Unit 1 
WT2 on Tape Unit 2 
Rewind and check out-of-order conditions of WT's 
Data in USDA: None 
WTS Used: No 


. Solution: Punch Order Card as follows: 
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b. .TLW Tape Label Write 


1) 


Purpose and Operation 


This Order calle out the program for recording standard labels. It 


will record any number of tapes (except, of course, the MT or ST) 
aa follows: 


a) Read first Detail Card. 


b) . If correct, rewind tape, execute two erase instructions, and 
record labels and TM's. 


. ¢) If an error is found in a card, the program continues checking 


all parameters to disclose all possible errors in the card, but 
that tape is not labelled. 


da) The program continues checking subsequent Detail Cards and 
writing the labels, 


e) if errors were found in Detail Cards, the program ultimately 
stops at address 02A6. 


f} Rewind tapes at end of program. 
g) .TLW records the following information on each tape: 
4 Tape Header Label: 
VOLIL for 9-track tapes 
INT1 for 7-track tapes 
. File Header Label: HDR1 


.. Two TM's 
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-TLW 


. Trailer Label: 
EOVI if end of tape 
EOF1 if end of file 


. Two TM's 
2) Parameter Cards 
The Order uses an Order card, one Detail card for each 


tape to be labelled, and an End card, formatted as 
follows: 


ORDER CARD 


-TLW 


Not significant 
Optional ID Code. 
Blank, 


DETAIL CARD 


1-4 ‘TLW 


5 Punch 7 if 7-track 
Punch 9 if 9-track 


6-7 W1 to label WT1 
W2 to label WT2 
W3 to label WT3 
or Select number of unit containing tape to be labelled 


GL to #8). 


I-30 


ETOS PROGRAMMER'S MANUAL 
- TLW 


Punch 0 for even parity. 
Punch Pfor odd parity. 


Recording Density: 
K = 1600 bpi 
L = 800 bpi 
M= 556bpi 
N= 200bpi 


Punch V if EOVI. 
Punch F if EOFI. 


11-16 Tape Serial Number. 

17 - 26 User's Name. 

27 - 43 File Name. 

44-49 | Serial Number of first tape (volume) of file. 

50 -53 Sequence number of tape within file. 

54-59 Labelling date (bYYDDD). If date not entered here, 


the day's date loaded by preceding . INT Order 
card isused. The day's date is always used as 
the purge date. 


60 - 80 Not significant. 


END CARD 


YEND 


Not significant. 
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8) Condition Checking Messages 


address 


*UNIT X: PERSISTENT ERROR 
(in recording) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after write command 
If during final rewind, program ends 
normally. 


*INVALID DETAIL CARD 
Card name wrong. 
Tape not labelled. 


*TAPE UNIT CODE WRONG 
(cols. 6-7) 
Tape not labelled. 


*ILLEGAL PARITY CHECK CODE 
(col. 8) 
Tape not labelled. 


*ILLEGAL DENSITY CODE 
(col. 9) 
Tape not labelled. 


*INVALID DATE 
(cols. 54 - 59) 
Tape not labelled, 
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“ILLEGAL TRAILER LABEL CODE 
(neither V nor F in Col, 10) 
Tape not labelled. 


*INVALD TRACKS NUMBER 


(neither 7 nor 9 in col. 5) 
Tape not labelled. 


*END OF TAPE LABEL WRITE 


4) Example 


Problem: To label WT1 and WT2 

WT1 = S/N0A1251, Sequence number 0001. 
WT2 = S/N 0A1205, Sequence number 0001, 
Record in 9-track mode, 

Use 800 bpi, with odd parity. 

Record EOF1 labels. 

Use today's date (see . INT Order). 


Solution: Punch four cards as follows: 
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2. "TRANSLATE and GO" Orders 
a. .APS Assemble APS Program 
1) Purpose and Operation 
This Order calls out the APS Assembly program for 
translating from source to machine language. For details 
on the operation of the Order, see the GE-130 APS Manual; 
listed in Appendix B of this book. 


2) Parameter Cards 


The Order uses an Order Card only, formatted as follows: 


Contents 
Los 4 APS 
5 } if source program is on cards and in one of following 
languages: 
130 APS 
115 Basic APS 
115 APS I 


1 if source program is on cards and written in 115 


Extended APS. 
2 if source program is on WT1 and written in: 
130 APS 
115 APS If 
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} if assembling program. 
1 if assembling 8/R. 


Program or 8/R name 
Comments. 

Not significant. 
Optional ID Code. 
Blank. 
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b. .COB Compile COBOL Program 
1) Purpose and Operation 
This Order calls out the COBOL Compiler for translating programs 
from source to machine language. For details on the operation of 
the Order, see the GE-120/130 COBOL Manual, listed in Appendix B 
of this book. 


2) Parameter Cards 


The Order uses a single Order card, formatted as follows: 


-COB 
Not significant 


Punch T to indicate compile in a Tape System. 


Punch L to request listing of object program, 


Otherwise }. 


Punch T is source program is on tape. 
} if on cards. 


Blank. 


If T in col, 11, punch tape unit Select number containing 
source program. 


Blank. 
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a »FOR Compile FORTRAN Program 
1) Purpose and Operation 
This Order calls out the program which translates programs 
from source to machine language. For details on the 


operation of the Order, see the GE-130 FORTRAN Manual, 
listed in Appendix B of this book. 


2) Parameter Cards 


The Order uses a single Order Card, formatted as follows: 


-FOR 


Not significant. 


Punch § if 7-track tape. 
Punch N if 9-track tape. 


Punch T 
Punch C 


if source program is on tape. 
af on cards. 


Punch L if object program listing is required. 
$ if not required. 
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Contents 


12 | Not significant. 
| 13 | 3 (fixed character). 


, 14 | Indicates Core Store size for exeoution 
| 3 = 12K 
4= 16K 
57 24K 
6 = 32K ° 
15 | Punch 1 if object program uses tapes. 
% if tapes not used. 


16 | Blank. 
17 | Punch 1 if object program uses Card Punchs 
% if Card Punch not used. @] 


18 - 20 | Indicates number of columns in Printer 
104 = 104 colums 
120 = 120 be 


HB = 1360" 


21 ~ 25 | Indicates initial address of object program in Core 
Store. oO 


26 ~ 33 | Program name. 
34-72 | Not significant. 
73 - 76 | Optional ID Code. 


717 - 80 | Blank. 
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C.SPG ) 


a. -SPG Generate SORT/MERGE Program 
1) Purpose and Operation 


This Order calls out the SPG Generator which translates 
SPG source programs into APS language, which is then 
translated into machine Language by an .APS Order. For 
details on the operation of the Order, see the GE-120/130 
SPG Manual, listed in Appendix B of this book. 


2) Parameter Cards 


One Order card is required, formatted as follows: 


o5PG 
Blank 
Name of program to be generated 
Program description, to appear as the heading of 
program listings 
Blank, if the source program is on cards, 
1, if the source program is on tape mit 1. 
Blank, if there are no auxiliary sections 
or if they are on cards. 
1, if they are on tape. 
Tape recording density: 
1.= 200 bpi 
2 = 556 bpi 
3 = 800 bpi 
4 =1600 bpi 
Blank if the parameters are on cards 
or on tape with odd parity, 
1, if the parameters are on tape with even parity. 
Blank 
Optional ID Code 
Blank 
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.*) 


The .APS Parameter card (page IYI-34) is used after the .SPG card with 
the following format: 


Contents 


APS 
Punch 2 to indicate source program is read from WI. oO 
} to indicate that it is a program being assembled. 


Name of program to be assembled. 


Program description, to appear as the heading of program 
listing. 


Not significant. 
Optional ID Code. 


Blank. 
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e. .API Assembled Program Insert 


1) 


NOTES: . 


Purpose and Operation 


This Order follows a translation Order and permits Type 1 or 3 
program to be inserted into the ST. Also, whenever possible, it 
standardizes the length of program blocks to 4096 characters, 


The assembled Type 1 program is added o the end of 
existing Type 1 programs. In Type 3, the new program 
is inserted immediately after the "normal" programs 
(iL e., those not generated by the .DPG Order, which 
are stripped off the tape). 


. Since the .APS Order loads the object program on WT2, 
the .API Order must be executed immediately afterwards, 
or after Orders which do not alter the contents of WT2. 


The program is inserted into the tape as follows: 


a) Rewind WT2, 


b) On Type 1 programs: 
. Position ST at beginning of S/R library. 
Write contents of ST on WT2 after assembled Type 1 
program. 
. Position ST after the Type 1 programs and copy from 
that point, standardizing block lengths of new program 
being inserted. 


c) On Type 3 programs: 
. Position ST after normal Type 3 programs, and before 
.DPG generated programs. 
‘ Write new program on ST from that position, 
standardizing block lengths and deleting .DPG 
generated programs. 


d) Rewind both tapes. 
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API 


2) Parameter Cards 


The Order uses an Order card only, formatted as follows: 


API 
Program Type (1 or 3) of assembled program. 
Name of program to be inserted 


Not significant 


Optional ID code 


Blank, 
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API 
8) Condition Checking Messages 


Stops at 
TITLE and NOTES 


*UNIT X: PERSISTENT ERROR 
(vead or write) 


Message 
Number 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 

If during final rewind, program ends 
normally, 


* PROGRAM X NOT FOUND (on WT2) 02A6 
(cols. 6 - 13) 
*MULTIPLE PROGRAM NAME TX 02A6 
(already on ST) 
New program is inserted, old program to 
be removed with .STS Order. 
*TLLEGAL PROGRAM TYPE (col. 5) 02A6 
*INVALID LABEL (on WT2) O2A6 


*PROGRAM LABEL...... 
(Label recorded on WT2 is printed) 


*END OF ASSEMBLED PROGRAM INSERT 
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Example 


. Problem: Insert Type 3 program, PHASE}4, in the ST. 
The program was assembled by the .APS Order. 


+ Solution: The .APIi Order card is formatted as follows: 
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f. .PRL Program Load 


1) 


Purpose and Operation 


This Order calls a program which searches for, loads into Core 
Store, and starts a Type 3 program located in the ST or MT. In 
addition, if the program is on the ST, it may be executed with 


. Path Trace Routine (printing all jump instructions which have 


eccurred), It is also possible to load and start a program 
generated for debugging (see .DPG Order) which is in the ST. 


The program consists of: 
Program Loader 
Path Trace Routine 
The sequence of operations is as follows: 


a) Load Trace Routine into Core Store, if requested. 


b) Search for the desired program and load the associated File 
Table into Core Store. 


c) Read the LBC cards, if any, and update the File Table, 


d) Load 'OA' (hexadecimal) in all available Core Store locations, 
if requested, 


e) Load user data into USDA, if requested. 


f) Call the Segment Load routine which loads the first program 
segment and starts processing. 
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» PRL 


g) Before program start-up a HLT occurs at address 01D2, if requested. 
In this case press START on CPU console to begin processing. 


2) Parameter Cards 


The Order and End cards are always used. The LBC cards are used only 
if the File Table is to be updated. The cards are formatted as follows: 
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ORDER CARD 


-PRL 


Name of program to be loaded. 


13 Punch C if program to be loaded is generated by .DPG 
Xs if otherwise 

14 Punch P if Trace Routine requested. 
Xs if otherwise 

15 Punch H if HLT to be executed before starting program. 


¥ if otherwise 


16 b if 'OA' to be loaded in available store. 
af otherwise. 


lq *if data to be transferred to USDA, 
% if otherwise 


18 - 49 Data to be transferred to USDA. 
50 - 72 Not significant. 
73 - 76 Optional ID Code. 


Blank 


LBC CARD 


The LBC card format is described in Appendix D since it is used in other 
Orders, 
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»PRL 
END CARD 
r 
Columns Contents 
1-4 ¥YEND 
5 - 80 Not significant 
3) Condition Checking Messages 
FOR ST 
Messages Stops at 
Number TIRE and NOTES Address 
2101 *UNIT X: PERSISTENT ERROR (in reading) 02A6 
2102 *UNIT X: OUT OF ORDER 
If after read command O2A6 
If during final rewind, the program ends 
normally. 
2106 *INVALID DETAIL CARD 02A6 
2108 *PROGRAM TX NOT FOUND 02A6 
2120 MINVALID PROGRAM NAME 02A6 
(cols. 5 -12 of LBC Card or col, 13 or 
.PRL Card). See NOTE at end of Table. 
2124 * MAIN UNIT CODE WRONG 02A6 
(LBC Card, col. 43). See NOTE at end of 
Table. 
2125 * ALTERNATE UNIT CODE WRONG 02A6 
(LBC Card, col. 44). See NOTE at end a 
of Table. 
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*ILLEGAL DENSITY CODE 02A6 


(LBC Card, col.51),See NOTE at end of Table. 


*FILE IDENTIFICATION CODE X NOT FOUND 02A6 
(In File Table) 
(LEC Card, cols. 13-18). See NOTE at endof Table. 


*INVALID DATE (on LBC Card). See NOTE at end of 02A6 
Table, 


*USER DATA CODE WRONG (PRL Card, col. 17) 0246 
*MEMORY LOADING CODE WRONG (PRL Card, col, 16} 02A6 
*HALT CODE WRONG (PRL Card, col. 15) 0246 
*INVALID FILE CHECK OPTION CODE 02A6 


(LBC Card, cols. 45-50). See NOTE at end of Table. 


*FILE TABLE OVERFLOW 0246 
Indicates one of the following conditions: 
1)File table starting address less than 12 K and 
final address greater than 5376 decimal. 
2)File table starting address greater than or 
equal to 12 K and final address beyond usable 
Core Store capacity. 


*FILE TABLE NOT FOUND 02A6 
Program to be loaded has no File Table. 
Followed by message 2106. 


*TRACE ROUTINE CODE WRONG 02A6 
(PRL Card, col. 14) 


*EXECUTION WITH TRACE ROUTINE IMPOSSIBLE 
Program starts anyway 


*END OF PROGRAM LOAD 


NOTE: When error is in LBC card, the program finishes checking that card, 
before stopping at address 02A6. 
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»PRL FOR MT AND MONITOR 


*UNIT X: PERSISTENT ERROR 
Press START to reload Pilot 0. 


*UNIT X: OUT OF ORDER 
Press START to reload Pilot 0. 

If message 2284 follows, ID sequence 
Vaildity Switch is not changed. 


*INVALID DETAIL CARD 
(LEC Card, cols. 1 -4) 
MT is rewound. Press START to reload Pilot 0 
See Note at end of Table. 


*PROGRAM X NOT FOUND 
(. PRL Card, cols. 5 - 12) 
MT is rewpund. Press START to reload Pilot 0 


02A6 


01D6 
02A6 


0246 


*INVALID PROGRAM NAME 0246 
(LBC Card, cols. 5 -12) 


{same us for message 2206) 
+ MAIN UNIT CODE WRONG O02A6 


(LBC Card, col. 43) 
(same as for message 2206) 


* ALTERNATE UNIT CODE WRONG O2A6 
(LBC Card, col. 44) 
(same as for message 2206) 
*ILLEGAL DENSITY CODE | 92A6 


(LBC Card, col, 51) : 
(same as for message 2206) 
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*FILE IDENTIFICATION CODE X NOT FOUND 
(in File Table) (LBC Card, cols. 13 ~ 18) 
(same as for message 2206) 


*INVALID DATE 
(LBC Card) (same as for message 2206) 


*USER DATA CODE WRONG 
(. PRL Card, col.17) MT is rewound. 
Pilot 0 reloaded by pressing START 


* MEMORY LOADING CODE WRONG 
(. PRL Card; col. 16) MT is rewound. 
Pilot 0 reloaded by pressing START. 


*HALT CODE WRONG 
(. PRL Card, col.15) MT is rewound. 
Pilot 0 reloaded by pressing START. 


*INVALID FILE CHECK OPTION CODE 
(LBC Card, col. 45 ~ 50) 
(same as for message 2206) 


* FILE TABLE OVERFLOW 

Indicates one of the following conditions: 

1) File table starting address less than 12 K 
and final address greater than 5376 
decimal. 

2) File Table starting address greater than 
or equal to 12 K and final address beyond 
usable Core Store capacity. 


OZAG 


0246 


0246 


O2A6 


O02A6 


0246 


* FILE TABLE NOT FOUND O2A6 
Program to be loaded has no File Table. 


(Followed by message 2206) 


* YYDDD/START OF PROGRAM X 
Indicates beginning of program 


M-52 


ETOS PROGRAMMER'S MANUAL 


PRL 


*NEXT PROGRAM Is X 
*NEXT PROGRAM IS X WITH SWITCH 2 OFF/Y 01D8 
SWITCH 2 ON 
*NEXT PROGRAM SELECTED BY ORDER CARD 


*MASTER TAPE STOP 
Program is ended, MT is rewound. 


*NEXT PROGRAM X SELECTED BY ENDED PROGRAIL 
*END OF PROGRAM X 


NOTE: When error is in LBC card, program finishes checking that 
card before stopping at address 02A6. 


4) Example 


« Problem: Program, REVIS., generated by .DPG is to be 
loaded from ST. Path Trace Routine printout required. 
Available Core Store area set to 'OA' No data to be loaded, 
and no LBC Cards to process. 


. Solution: Punch card as follows: 
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g .APP Assembled Program Punch 


1) 


Purpose and Operation 


This Order is used to punch any Type 1 or 3 program recorded 
on the ST, or any program assembled on WT2 by the . APS Order 
(page TII-34). 

The sequence of operations is as follows: 


a) Select the proper Punch routine (for the type of 
Punch used in the system). 


b) Rewind tape and search for the desired program. 

c) Punch program in hexadecimal and print. 

The program also punches a PLC Card (with anIor anR 

in col. 36) to begin the deck; a SIN Card to begin each segment; 
and an END Card to finish the program, this when obtained 


can be used for any subsequent updating of the ST (see .STU 
order, page HI-99). 
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2) Parameter Cards 


The Order uses an Order card only, formatted as follows: 


Contents 


APP 


Type (1 or 3) or program to be punched 


Name of program to be punched. 


} if program to be punched is on ST. 
* if program is on WT2. 


15 -18 Program code to be punched in Cols. 1 - 4 of 
output cards. 

19 # if col. 36 of PLC Card is to be punched L 

R ifcol. 36 of PLC Card is to be punched R. 

20 * if the SIN or END card following a program segment 
is to be punched with the quantity (in decimal) of 
cards containing the segment. 

} if otherwise. 

21 - 72 Not significant 
Optional ID Code. 
Blank 
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3) Condition Checking Messages 


Message 
Number 


TITLE and NOTES 


*UNIT X: PERSISTENT ERROR (read) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read command 
If during final rewind, program ends 
normally, 


*PUNCH ERROR ON** CARD 

The incorrect card is identified in the card 
listing by two asterisks. Operator must 
repunch card correctly. 


*PROGRAM TX NOT FOUND (on ST or WT2) 


* PUNCH NOT CONNECTED 


“ILLEGAL PROGRAM TYPE 
(col. 5, . APP Card) 


*TAPE UNIT CODE WRONG 
(col. 14, .APP Card) 


* INVALID LABEL 
(WT2 program label) 

* ILLEGAL PLC TYPE CODE 
(col. 19, .APP Card) 


* ILLEGAL CARD COUNT CODE 
(col. 29 of . APP Card) 
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*PROGRAM LABEL:......... 
(if program is punched from WT2, label 


is printed). 
*END OF ASSEMBLED PROGRAM PUNCH 


4) Example 


» Problem: A program assembled by the . APS Order, is 
to be punched from WT2, 
Name: PHASEH3 
Program Code: 1509 
Program Type: 3 
PLC Card, col. 36: Punch I 


- Solution: Punch the following Order Card: 
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3. DEBUGGING ORDERS 
a. .TDC Tape Duplicate 
1) Purpose and Operation 
The Order is used te duplicate (either in part or all) any tape 
containing standard or non-standard data files, or to duplicate 
@ program tape (ST,LT, or MT), The output tape may retain 
none, part, or all of the blocks previously recorded on it. 
The program operates in the following sequence: 
a) Load input and output tapes to proper intial positions. 


b) Duplicate. 


NOTE: Any CHKP blocks on the input tape are disregarded by 
the . TDC program (see figure page If-154). 


2) Parameter Cards 


The Order uses an Order Card only, punched in the 
following format: . 
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Contents 


- TDC 


Type of file on input tape. 
KP if tape is ST, LT, or MT 

DS if tape contains standard data file. 

DN if tape contains non-standard data file, 


Wi if input tape is WT1. 
W2 if input tape is WT2. 
W3 if input tape is WT3. 
or the Select number of the unit containing 
the input tape ( 1 to fs 8). 


Parity of input tape 
O= Even 
P= Odd 


Recording density on input tape 


K = 1600 bpi 
L= 800 bpi 
M= 556 bpi 
N= 200 bpi 


Serial number of input tape, if it is to be checked. 
Otherwise, blank. 


Number of tape unit containing output tape (see cols. 
7 - 8 above). 


Parity of output tape (see col. 9). 
Recording density on output tape (see col. 10), 


Serial number of output tape, if it is to be checked. 
Otherwise, blank, 
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Punch C if file on input tape must follow a file already 
on output tape (permitted only if 'DS' in cols. 5 - 6). 
Otherwise, blank. 


File name, only if it must be changed on output tape 
(permitted only if 'DS' in cols, 5 - 6 and col. 27 
is blank). 

Otherwise, blank, 


File serial number only if it must be changed on output 
tape (same restrictions as for File Name). 
Otherwise, blank. . 


Output tape retention period. 

Blank if purge date is today's date, (Dates in HDR1 
label are updated only if 'DS' in cols, 5 - 6 and 
col, 27 ig blank). 


Quantity of initial blocks on input tape not to be 
duplicated. 

Blank if all blocks to be duplicated. (Significant only for 
non-standard files; i.e., 'DN’ in cols. 5 - 6). 


Quantity of intial blocks previously recorded on output 
tape to be retained. 

Blank if none. (In this case, two Erase operations are 
executed). 

(Significant only for non-standard files; i.e., 'DN' 
in cols. 5 - 6). 


Punch N if blocks are not numbered. (Significant only if 
'C' in col, 27). 
Otherwise, blank, 
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V, to close output tape with EOV1. 
Any other character, to close output tape with EOF1. 


Not significant. 


3 - 76 Optional ID Code. 


Blank, 


3) Condition Checking Messages 


Stops at 


TITLE and NOTES Address 


*UNIT X: PERSISTENT ERROR (read or write) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 
If during final rewind, program ends 
normally. 


5110 *UNIT X: SERIAL NUMBER Y WRONG/SHOULD 
BEN 
5116 *UNIT X: END OF REEL (output tape) 


1) Duplication completed. 
2) Duplication incomplete. 
Output tape closed by: 
» TM and Program Tape Trailer 
Label, if BP in cols. 5 - 6. 
. TM, if 'DN' incols5 - 6. 
» TM and EOF1 label (with incomplete 
block count) if 'DS' in cols. 5 - 6. 
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»TDC 


5117 *UNIT X: NON-STANDARD FILE O2A6 
(if ‘bP’ or "DS! in cols 5 - 6) 

5150 *PILE TYPE CODE WRONG 02A6 
(cols. 5 - 6) 

5151 *INPUT TAPE UNIT CODE WRONG 02A6 
(cols. 7 - 8) 

5152 *ILLEGAL INPUT PARITY CHECK CODE 02A6 
(col. 9) 

5153 * ILLEGAL INPUT DENSITY CODE 02A6 
(col, 10) 

5154 *OUTPUT TAPE UNIT CODE WRONG 02A6 
(cols. 17 - 18) 

5135 *ILLEGAL OUTPUT PARITY CHECK CODE O2A6 
(col. 19) 

5156 *ILLEGAL OUTPUT DENSITY CODE 02A6 
(col, 20) 

5157 *INVALID FILE APPENDING CODE 02A6 
(col. 27) 

5158 *INVALID RETENTION PERIOD 0246 
(cols. 46 - 48) 

5159 *INVALID NUMBER OF BLOCKS ON INPUT TAPE 02A6 
(cols. 49 - 53) 
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*INVALID NUMBER OF BLOCKS ON OUTPUT TAPE 
(cols, 54 - 58) 


*END OF TAPE DUPLICATE 


4, Example 


+ Problem: Tape duplication 
Input Tape Specifications 
Contents: Standard file 
Tape Unit Select Number: 2 
Parity: Odd 
Recording Density: 800 bpi 
Tape Serial Number: 000015 (tape to be checked) 


Output Tape Specifications 

Tape Unit Select Number: 3 

Parity and Density: Unchanged 

Tape Serial Number: 000024 (tape to be checked) 
File Serial Number and Name: Unchanged 
Purge Date: Today 

Input Tape Blocks to be Recorded: All 

Output Tape Blocks to be Retained: None 


+ Solution; Punch Order card as follows: 


1 5 0 5 20 tJ 30 35 
fel7Ic|DIs|_ 12/7 Hd ae oejoiol| 
2 
: SRGROGn 
4 
5 LI | La 
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b. -DPG Debugging Program Generate 


1) 


Purpose and Operation 


The Order is used for setting up controlled execution (debugging) 

of a Type 3 program on the ST, by inserting corrections in machine 
language, and by providing a Memory Trace Routine for printing 
out Core Store areas at specified trace points. 


The quantity of corrections and the use of the Memory Trace 
Routine is dependent upon Core Store availability. The Trace 
Routine must occupy a store area external to the Type 3 program 
area. Its length is 466 octets. 


A trace point table is loaded after the Trace Routine, and its 
length varies with the number of trace points requested. (The 

table consists of N records of 15 octets each), In specifying 

trace points, note that: a) Each trace point requires four octets 

to receive a jump instruction to the Trace Routine. Therefore 

the trace points must be specified at addresses containing 

4- or 6-octet instructions. b) The jump instruction destroys 

the previous contents of Register 7 (locations 254-255). 

¢) It is not permissible to insert trace points in macro-instructions 
or in the corrections introduced by CRT cards (see below). 


The modified program is written at the end of the Type 3 program 
library in the ST, and is identified by the character C in the 10th 
position of its label. The .DPG program operates as follows: 


a) Search ST for program specified by Order card. 
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-DPG 


b) Write program on WT1, inserting any corrections (CRT cards) 
at the end of each segment. 


ce) Transfer corrected program from WTI to ST. 


da) If Trace Routine is requested (DTR Card), it is inserted 
at end of first segment of Type 3 program, and after any 
corrections that have been made. The jump instructions 
(TRC Cards) are inserted in the corrected program. The trace 
point table is recorded after the Trace Routine. (This table 
contains Memory Trace specifications (TRC Cards) and directs 
the operation for each trace point in Type 3 programs). 


At the end of the .DPG Order the Type 3 program will have 
the following Debugging Format on ST: 


Isr SEGMENT 
2nd stenenr 3rd SEGMENT 


ath seomenT 
fand soon) 


2) Parameter Cards 


.DPG uses an Order card, three types of Detail cards, and an 
EMD card, The Detail cards are used in the following sequence: 


CRT (Correction Card): when used, they are arranged in 
ascending segment numbers. 
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DIR @efine Trace Card): When used, only one is 


required for the program. 
TRC (Trace Point Card):_ When used, one card is 
needed for each trace point and they are inserted in 
card deck in ascending segment numbers, and by ascending 
addresses within each segment. 


The parameter cards are formatted as follows: 


ORDER CARD 


-DPG 


Name of program to be prepared for debugging 


* if all programs generated by previous .DPG orders are 
to be deleted from ST. 

Otherwise, blank. 

Not significant 

Optional ID Code. 

Blank. 


1-65 


.DPG 
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CRT CARD 


Contents 


¥CRT 


Length of correction (punched in hexadecimal). 


Address in Core Store where correction is made 
(punched in hexadecimal). 


Correction in machine language (punched in hexadecimal), 
Not significant. 
Number (in decimal) of segment affected by correction. 


DTR CARD 


¥DTR 
Start address of Trace Routine in Core Store, 
Not significant. 


TRC CARD 


BTRC 


Decimal number of segment where trace point is required. 
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Hexadecimal trace point address in Core Store where jump 
instruction to Trace Routine is to be inserted. 


Initial address (in hexadecimal) of store area to be 
printed. 


Length (in hexadecimal) of store area to be printed. 


Net significant. 


END CARD 
END 


Not significant, 


3) Condition Checking Messages 


TITLE and NOTES Stops at 
Address 


* UNIT X: PERSISTENT ERROR 
(read, write or verify) 


* UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 
If during final rewind, program ends 
normally. 
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Stops at 


INVALID DETATL CARD 
PROGRAM TX NOT FOUND (on ST) 


MULTIPLE PROGRAM NAME TX 

ST contains another debugging format 
program with the same name. The Order 
program proceeds to its end before stopping 
at address 


DATA CARD WRONG 
(refers to last one read and printed) 


SEGMENT NUMBER X WRONG 

(colse 79 = 80 of CRT, colse 5 — 6 of TRC) 
Segment number in descending order, or not 
in decimal. 


SEGMENT NUMBER X NOT FOUND 


DATA LENGTH WRONG 
(cols. 5 = 6 of CRT, cols. 15 - 18 of TRC) 


INVALID ADDRESS 


(on CRT, DER or TRC, or an odd address is 
specified on DIR) 


GENERATED PROGRAM OVERFLOW 
{in Core Store) 
TRC TABLE OVERFLOW 


(Trace point table too long for available 
store) 


Rev. Nov. 1969 
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Ce eSGE Samples Generate 
1) Purpose and Operation 


This Order permits the recording of a sample file on a WT, 
from data contained in Detail cards. Standard or non- 
standard files with numbered or un-numbered blocks can be 
written. 


If a standard file on a labelled tape is desired, the 
program automatically closes the file. If there are t *) 
variable length records, the lengths must be indicated by 
the user in the first two characters of each record, The 
maximum block lengths depend on Core Store capacity, as 


follows: 
Core Store Block Length 
12K TK 
| 16K 11K Ce] 
24K 19K 
32K 27K 


The program operates in the following sequence: 


a) Rewind the WT. 


bp) Position the W? following the blocks to be retained. 
If there are none, execute two erase operations. i*) 


c) Read, print and record the Detail cards on the WI. 
a) Close the file as specified by the nd card, and 
rewind both the ST and the Wi. 
2) Parameter Cards 


eSGE uses an Order card, four types of Detail cards, and 
an End card. The Detail caris are used as follows: 
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«SGE 


SBL (Start Block) One for each block. 


BLK (Block) These cards contain the data to be recorded in the block, The 
number of BLK cards will vary 


EBL (End Block) Signals the end of the BLK cards. One for each block. 
TPM (Tape Mark) Used to record a TM where required, 


The parameter cards are formatted as follows: 


HUMBER OF SEQUENCES VARIABLE, 
DEPEIDING ON LENGTH OF FILE 


m-71 


ETOS PROGRAMMER'S MANUAL 


-8GE 
ORDER CARD 


Contents 


-SGE 


W1 if outputtape is WT1. 
W2 if output tape is WT'2. 
W3 if output tape is WT3, 
Or Select number of unit containing the output tape 


(BL to #8). 


Parity Check Code 
O = Even 
P= Odd 


Recording Density Code 


K = 1600 bpi 
L= 800 bpi 
M= 556 bpi 
N= 200 bpi 


Indicates character type on BLK Detail cards. 
X = Characters punched in hexadecimal (applicable 
only on 9-track tape). 
Alphameric characters can be inter-mixed by 
punching a period (.) before each alpha character. 
Therefore, each two characters (either alpha or 
hexa) are recorded as one character on tape. 


= Alphanumeric characters only. (Each single character 
is recorded as a character on tape). 


Quantity of blocks to be retained on WT. To obtain a standard 
file on a labelled tape, it is necessary to retain at least 
three blocks. 


-72 


ETOS PROGRAMMER'S MANUAL 
.SGE 


Columns Contents 


Not significant 
Optional ID Code. 
Blank. 


al 


DETAIL CARDS 


SBL (Start Block) 


KSBL 


Sequence number of block (in decimal) to be recorded. 
K if block is not numbered. 


Not significant. 


BLK (Block) 


1-4 BBLK 
5-6 Number of characters (in decimal) to be recorded on WT. 


7 - 80 The characters to be recorded. 


EBL (End Block) 
1-4 | EBL 


5 - 80 Not significant. 


Ge nae | ee: 
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. 8GE 


Contents 


TPM (Tape Mark) 


BIPM 
Not significant 


END CARD 


1-4 KEND 
5 Specifies type of file close. 
V = End of Colume (EOV1) 


F = End of File (EOF). 
b = File already closed by Detail card. The End 


card causes tape to be rewound, 
NOTE: File closing can be done by the .SGE 
program only if it is a standard tape, 
and the Order card has requested retention 
of at least three blocks. 


6-80 Not significant 
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3) Condition Checking Messages 


Number 


-SGE 


TITLE and NOTES 


*UNIT X: PERSISTENT ERROR (read or write) 


*UNIT X: OUT OF ORDER 
Tf after rewind command 
If after read or write command 
If during final rewind, program ends 
normally. 


*INVALID DETAIL CARD 


*UNIT X: HDR1 LABEL NOT FOUND (on WT) 
Program continues normally to END ecard, 
If no '$' in col. 5 of End card, program 
stops at address 


*UNIT X: END OF REEL 
Tape is closed with TM, EOF1 label, and 
rewound. 


*TAPE UNIT CODE WRONG 
(cols. 5 - 6, Order Card) 


*ILLEGAL PARITY CHECK CODE 
(col, 7, Order card) 


*TLLEGAL DENSITY CODE 
(col. 8, Order card) 


*ILLEGAL TRAILER LABEL CODE 
(col. 5, End card) 
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Stops at 
address 
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-SGE 


*DATA LENGTH WRONG 
Number of characters to be recorded 
(cols. 5 - 6 of BLK) not in decimal, or 
greater than 74, if B in col. 9 of .SGE 
" " 37, XxX ” " " 


*BLOCK LENGTH WRONG 
Length of block is greater than allowed 
by available Core Store. 


*BLOCK NUMBER WRONG 
Number expressed in cols. 5 - 9, SBL 
card, Quantity expressed in cols. 10 - 14 
. SGE card. 


*DATA RECORDING MODE WRONG 
(col. 9 .SGE card) 


*END OF SAMPLES GENERATE 


4) Example 


. Problem: To record a sample file of one block length 
on WT1, Standard file with numbered blocks. Close file 
with EOF1 label. 

Parity: Odd 

Recording density: 800 bpi 

Data punched in hexadecimal 

Blocks to be retained: 3 

(SBL) Block sequence number : 00001 


TH-%6 


+ Solution: Punch cards as follows: 
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1 5 10 5 20 EJ Ed 
7\o SGM? Q (a ‘ 
2| siaicicecior 
w {ee , 
IL |X| 
W#3| AL. 
N49 | lea, 
Ht rH 
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de eTDP Tape Dump 
4) Purpose and Operation 


This Order permits the printout of 2 specified portion of 
@ tape, either in hexadecimal or in alphameric characters. 
The maximum block lengths depend on Core Store capacity, 
as follows: 


Core Store Block Length 
12k TK 
164 17K © 
24K 19K 
32K 27K 


The Order operates in the following sequence: 


a) Rewind tape to the position preceding first block to 


be printed. re) 


b) Print the following heading: 
3277 *TAPE DUMP OF UNIT X FROM BLOCK ¥/BLOCKS 2 
(See Condition Checking Messages). 


c) Print a line at the head of each block, showing block 
sequence number and quantity of characters it contains. 


a) The program stops after printing the number of blocks re) 
specified in the Order card; or after printing the 
Yrailer Label if the quantity of blocks is not specified. 


e) Rewind tape. 
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2) Parameter Cards 


The Order used an Order card only, formatted 2g follows: 


-4 . TDP 


W1 to print WT1. 
W2 to print WT2, 
W3 to print W77 
ST to print ST (or MT) 

Or Select number of unit containing tape to be printed 
(B61 to B8). 


Parity Check Code 


O =Even 
P=0Odd 


Recording Density 


K = 1600 bpi 
L= 800 bpi 
M= 656 bpi 
N= 200 bpi 


Specifies type of printout 


X = Print hexadecimal 
} = Print alphanumeric 


Number of first block to be printed. 
If not indicated, printing starts at first block on the tape. 
On a standard tape, this would be at the label, VOL1 or INT1. 


10-14 
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-TDP 


Quantity of blocks to be printed. 
If not indicated, all blocks will be printed and 
a Trailer Label will be printed at the end. 


Not significant 
Optional ID Code. 


Blank. 


3) Condition Checking Messages 


Message TITLE ond NOTES 
Number 


3201 *UNID X: PERSISTENT ERROR (read) 
Tape is rewound and Pilot 0 is restarted. 


$202 *UNIT X: OUT OF ORDER 
If after rewind command OLDA 
If after read command 0246 
If during final rewind, program ends 
normally. 

3223 TAPE UNIT CODE WRONG 02A6 
(cols. 5 - 6) 

3226 *TLLEGAL PARITY CHECK CODE 02A6 

3227 *TLLEGAL DENSITY CODE 02A6 
(col. 8) 
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*BLOCK NUMBER WRONG 
Number expressed in cols. 10 - 14 and/ 
or quantity expressed in cols, 15 - 19. 


*PRINTOUT MODE WRONG 
(col. 9) 


*TAPE DUMP OF UNIT X FROM BLOCK Y/BLOCKS Z 


X = Select mumber of unit on which 
tape to be printed is mounted. 

Y¥ = Serial number of first block to 
be printed. 

Z = Quantity of blocks to be printed. 


*END OF TAPE DUMP 


4) Example 


« Problem: To print the contents of the ST. 
Parity Check Code: Off 
Recording Density: 800 bpi 
Type of printout: Hexadecimal 


. Solution: Punch the Order Card as follows: 
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CRD 
e. .CRD Card Dump 

1) Purpose and Operation 
This program is used to execute a listing of all parameter cards in 
a given Order, to check for correctness of the deck. The program 
reads and prints the cards simultaneously, providing an 80/80 
listing of each card. 

2) Parameter Cards 


The program uses an Order card and an End card, formatted as 
follows: 


L CANO pace 70 a8 e1sren 


ORDER CARD 


«CRD 
Not significant 


B... (End) 


Optional ID Code. 
Blank 
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-CRD 


END CARD 


K... (To distinguish this End card from End card 
of deck being listed). 


Not significant. 


3)Condition Checking Messages 


Stops at 
TITLE and NOTES 


*UNIT X: OUT OF ORDER 


(during rewind) Program ends normally. 


*END OF CARD DUMP 


I-83 


»MDP 


ETOS PROGRAMMER'S MANUAL 


f .MDP Memory Dump 


y) 


2) 


Purpose and Operation 


The program permits the printout of a specified area in Core 
Store, both in the SRA, and in the area available for user 
programs, The SRA remains unchanged except for the printer 
reserved area (hexadecimal address 0200 to 02A1) and the area 
eceupied by the . MDP program (hexadecimal 02BC to 0474). 


The program is contained in block 4 of the Supervisor and is 
started by Pilot 1. Each line is printed in hexadecimal and 
is followed by a line printed in graphic characters. 
Parameter Cards 


The Order requires an Order card only, formatted as follows: 


= 


-MDP 


1-4 
5-8 
9 - 12 


Initial address (in hexadecimal) of Core Store area 
to be printed 

} if printout is to start at initial address of area 
available to user. 


Final address of Core Store area to be printed. 
¥ if Core Store is to be printed up to its final 
address. 
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Contents 


Not significant. 


Optional ID Code. 


Blank 


3) Condition Checking Messages 


Stops at 

Address 
* MEMORY DUMP OF PROGRAM X | 
Name of last program loaded into Core 


Store. This message appears at the 
head of the printout. 


® END OF MEMORY DUMP 


4) Example 
. Problem: To printout Core Store contents from the 
initial address of the area available to the user, 


through end address 105C (hexadecimal). 


+ Solution: Punch the Order card as follows: 
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-PCC Punched Card Check 


1) 


2) 


Purpose and Operation 


This Order is used. to verify the program cards punched 
by the .APP Order, against the original program on ST 
or WT2. 


The program operates as follows: 
a) Search ST or WT2 for required program, 


%) Contents of program cards are compared with the 
program on tape. 


ce) If discrepancies are detected, the incorrect card(s), 
identified by two asterisks, are printed out, together 
with the corresponding information on tape. ‘ 


. Parameter Cards 


The Order uses an Order card only, which is followed by 
the program card deck punched by the .APP Program. .See 
page III-53, paragraph under ¢). 


The Order card format is shown in the following table. 
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«PCC 


PCC 


Type (1 or 3) of program to be checked. 


Name of program to be checked. 


¥ if original program is on ST. 
* if original program is on WT2. 


Program code, punched in cols. 1 - 4 of program 
cards. 


¥ if col. 36 of PLC card contains a "I". 
Rif col. 36 of PLC card contains an "R". 


xif the SIN or END card following a program segment 
specifies the quantity (in decimal) of the cards containing 
the segment. 

} if otherwise. 


Not significant. 
Optional ID Code. 


Blank, 
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3) Condition Checking Messages 


Measage Stops at 


*UNIT X: PERSISTENT ERROR (read) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read command 

If during final rewind, program ends 
normally. 


*PROGRAM TX NOT FOUND (on ST or WT2) 


*ILLEGAL PROGRAM TYPE 
(col. 5, . PCC card) 


*TAPE UNIT CODE WRONG 
(col.14, . PCC card) 

*ILLEGAL PLC TYPE CODE 

(col.19, . PCC card) 


5850 *ILLEGAL CARD COUNT CODE 
(col. 20,.. PCC card) 
5861 *ERROR ON CARD 


Incorrect card(s), identified by two 
asterisks, are printed out, together with 
the corresponding information on tape. 
Incorrect characters are indicated by 
arrows. Program continues to end, but 
stops at address. 


*END OF PUNCHED CARD CHECK 
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«PCC 


Example 


4) 


‘ify the program card deck punched by the 


APP Order (see page I-56). 


Problem: Ver: 


Punch the following Order card: 


Solution: 
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h. .PSC Punched Subroutine Check 


1) 


Purpose and Operation 


This Order is used to verify the program cards punched by the 
- SBP Order, against the original information on ST or WT2. 


The program operation is similar to that of the .SBP program, 
but results in a comparison rather than in punching/printing . 
It also performs the same checking operations as the .SBP 
program. 


If discrepancies are detected between the contents. of cards and 
the original information on tape, the incorrect card(s), identified 
by two asterisks, are printed out, together with the corresponding 
information on tape. 
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2) Parameter Cards 


The program uses an Order card only, formatted as follows: 


= 


+ PSC 


Name of 8/R to be checked, 
* in col. 5 if entire S/R Library is to be checked. 


* if 8/R was punched from WT2. 


Bit 8/R was punched from ST. 

This column is significant when checking one 8/R 
only. 

Not significant. 

Optional ID Code. 

Blank, 


8) Condition Checking Messages 


——_ 


5501 * UNIT X: PERSISTENT ERROR (read or 
write) 02A6 
$502 *UNIT X: OUT OF ORDER 
¥f after a rewind command 01DA 
If after a read or write command O2A6 
ff during final rewind, program ends 
normally. 
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*PUNCH ERROR ON **CARD 
Incorrect card(s), identified by two 
asterisks, are printed out together 
with the corresponding information on 
tape. 

Program continues to end, but stops 
at address, 


* SUBROUTINE YX NOT FOUND 
(on ST or WT2) 


* TAPE UNIT CODE WRONG 
(col,11, .PSC card) 


*INVALD LABEL 
Label generated by APS Assembler not 
found on WT2. 


* INVALID SUBROUTINE NAME 
(cols. 5-10 of Order card) S/R name 
does not commence with Y. 


* SUBROUTINE ADDRESS WRONG 
The initial address of the S/R is 
not 0000. 


*SOURCE STATEMENT WRONG 
A programming restriction has been 
disregarded (see "Restrictions", page 
Ii-118). The wrong instructions are 
printed out. 


*END OF PUNCHED SUBROUTINE CHECK 
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+ PSc 
4) Example 
Problem; To verify the S/R punched on cards by the 
«SBP Order (see page I-56. 5). 
Solution: Punch the Order card as follows: 
70 6 80 
B\B|3} 
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. PSI 


i... PSI Punched Subroutine Insert 


1) 


2) 


Purpose and Operation 


This Order permits one or more S/R'‘s to be inserted in the 
Library on ST, using the cards punched by the . SBP Order. 


It operates as follows: 


a) 
b) 
ce) 
a) 


e) 


Read S/R Index from ST into WT1. 
Read S/R(s) from cards into WT2. 
Update S/R Index on WT1. 


When End card is read, write contents of ST and WT2 
on WT1 inserting S/R(s) at the end of S/R Library. 


Copy WT1 to ST. 


Parameter Cards 


The program uses an Order card, one or more Detail cards 

(SSB) and an End card. Each SSB card is followed by the program 
cards containing the S/R to be inserted. These cards are described 
under .SBP, page I1-56.2. The Parameter cards format is shown 
in the following tables. 
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» PSI 
ORDER CARD 


Contents 


«PSI 


Not significant, 


Optional ID Code. 
Blank. 


DETAIL CARD 


SSB (Start Subroutine) 


KSSB 
Length, in hexadecimal, of information punched in 
cols, 17 - 62. 


Name of S/R to he inserted. 
Length of S/R, in hexadecimal. 


Names of S/R(s) called out by the S/R to he inserted 
(max, six S/R's). 


Not significant. 


END CARD 


¥END 


Not significant. 
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. PSI 


3) Condition Checking Messages 


Message 


5601 *UNIT X: PERSISTENT ERROR (read or 
write) 


*UNIT X: OUT OF ORDER 

If after a rewind command 

If after a read or write command 

If during final rewind, program ends 
normally. 


*INVALID DETAIL CARD 
Detail card(s) missing or out of 
sequence, 


Stops at 
address 


*SUBROUTINE YX NOT FOUND 
The S/R YX called out by the S/R 
specified by the previous SSB card, is 
not present in the library on ST. This 
S/R is not inserted but the program . 
continues to end, then stops at the 
address. 


* CARD COUNT WRONG 
Cards containing S/R do not have 

- consecutive ascending sequence numbers 
(cols, 13 - 16 of card described on page 
I-56. 2). 

The S/R is not inserted but the program 
continues to end, then stops at the 
address. 
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*MULTIPLE SUBROUTINE NAME YX 
S/R specified for insertion is already in 
Library. The program processes the 
other cards, then stops at the address 02A6 


*INVALID DATE 
{cols. 7-12 of S/R card, page HI-56. 2) 
The S/R is not inserted, but the program 
processes the other cards, then stops 02A6 
at the address. 


*INVALID SUBROUTINE NAME 
SSB and associated S/R cards have 
different S/R name, or not commencing 
with Y. The 8/R is not inserted, but 


the program continues to end, then stops 
at the address. 02A6 


*DATA CARD WRONG 
Information in cols. 19-80 of S/R card 
(page HI-56. 2) not in valid form. 
S/R not inserted, but program. continues 
to end, then stops at address. 02A6 


*DATA LENGTH WRONG 
(cols. 17-18 of S/R card, page HI-56. 2) 
S/R not inserted but program continues 
to end, then stops at address. 02A6 


*END OF PUNCHED SUBROUTINE INSERT 
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Example 

+ Problem: To insert in Library on ST the S/R punched 
on cards by the .SBP Order, and verified by the . PSC 
Order, (see page II-56.5) 


. Solution: Punch the following Order card: 
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ie eTCK System Tape Checking 
1) Purpose and Operation 


This program is used to check the new System Tape 
generated on WI2 from the current ST and WI by means 
of the .TPU program. 


The program is in five segments, operating as follows: 


» Segment 1 (Read first Detail card and call appropriate 
segment) 


Same operation as described under .TPU (page TIT-150.8), 
except that two block read areas are provided, each 
occupying 4096 Core Store locations. 


« Segment 2 (check ST duplication) 
Compare previous ST with WI2. 


- Segment 3 (check Operating System replacement) 
Compare Operating Systems on WI and WT2. 
Compare Type 3 programs on ST arid WI2. 


« Segment 4 (Read and store Detail cards) 


Same operation as described under .TPU, 
page III-150.9. 
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oO 


« Segment 5 (Check updated System Tape) 
a) Rewind ST and check labels (if requested), 


b) Check W22, comparing its contents with previous ST 
and WI'1, and signal which blocks are invalid, and 
why. This validity check has obviously some 
limitations which cannot be stated here. In any 
case the program provides the number of any error 
block (header labels and TM's are also counted), 
both for WI2 and the tape used for comparison, thus 
allowing, by means of the .TDP (Tape Dump) progran, ° 
to inspect tapes starting from the blocks signalled. 


c) Print out the unprocessed Detail cards (see message 
71741). They contain some errors which cannot be 


detected during program execution. 


a) Rewind tapes. e) 


TII-O5.16 Add. Nov. 1969. *) 


ETOS PROGRAMMER'S MANUAL 


20) 


Parameter Cards 


The .TCK program requires an Order card, up to four types 
of Detail cards (described below) and an End card. 


PIN (Program Insert) is used to check the insertion of a 


new program from WT1. 


PRR (Program Replace) is used to check the replacement of 


@ program on ST with an updated version on WI. 


PRD (Program Delete) is used to check the deletion of a 


program or a series of consecutive programs on ST. 


gk Operating System Replace) is used to check the 
replacement of the Operating System on ST (except for the 
Supervisor) with an updated version on WT. 


The Parameter cards are formatted as follows: 
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ORDER CARD 
Columns Contents 
1-4 oTCK 
5-10 | Serial number of ST, if checking requested. Otherwise blank. 
11 - 16 |Serial number of WI, if checking requested. Otherwise blanks 
17 - 22 |Serial number of WI2, if checking requested. Otherwise blank. 
23 = 72 | Not significant 
73-76 | Blank 
TT = 80 | Blanke 


DETAIL CARDS 


The PIN, PRR, PRD and @SR Detail cards have the same format as 
used for the .TPU Order (see pages starting from III-150.12). 


END CARD 


Same as for .TPU Orders 
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3) Condition Checking Messages. 


Message 
TITLE and NOTES 


* UNIT X: PERSISTENT ERROR (read) 


Stops at 
address 


* UNIT X: OUT OF ORDER 
If after rewind command 

If after read or write command 

If during final rewind, program ends 
normally. 


* PROCEEDING IMPOSSIBLE 


* INVALID DETALL CARD 
Name incorrect (cols. 1e- 4)e 
Program checks the other Detail cards. 
At the end, message 7705 is printed out 
and program stops at address 


* PROGRAM TX NOT FOUND 
(on ST or wo) 


* UNIT X: SERIAL NUMBER X WRONG/ 
SHOULD BB Y 


% MULTIPLE PROGRAM NAME TX 
Program to be inserted is already present 
on ST, 


* DETAIL CARD OVERFLOW/X LAST CARD 
Program continues and processes only the 
accepted Detail cards, then stops at 

address 
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* ILLEGAL PROGRAM TYPE 
(cols. 5 and/or 14 of Detail cards) 
Program checks the other Detail cards. At 
the end, message 7705 is printed out and 
program stops at address 


* DATA CARD WRONG 
Followed by printout of incorreot card 


OUTPUT BLOCK X WRONG Ce) 
KX is block sequence number 
One of the following additional 
specifications may appears: 


— PROGRAM TX NOT FOUND(on ST or WT1) 
— BLOCK LENGTH WRONG 
- BLOCK DATA WRONG ° 


- MISSING BLOCKS 
Tape Mark encountered on one tape only. 


SYSTEM TAPE INDEX 

Followed by listing of programs on new 

System Tape. Either of the following 

specifications may appear: 

- DUPLICATE *) 
if duplication from ST to WI2 was 
requestede 

- DUPLICATE: PROGRAMS TYPE 1 AND 2 
FROM WI1 AND PROGRAMS TYPE 3 FROM ST. 
Replacement of operating system was. 
requested. 


* END OF SYSTEM TAPE CHECKING 
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4) Example 
« Problem: To check System Tape generated on WT2 in the . 
example given for the .TPU Order 
(see page TII-150.18 ). 


« Solution: Punch cards as follows: 


1 5 0 5 20 a 30 35 


os 
ole eist 
S| 


Pe) 

As 
ATA 
A> 


Pal 
AS 
“14 


S| | 


= 


opel ish 
RERaeS 


ws 
hs 


e-Ba-Bh 3 


Comparisons are made between WT2 and ST or WT depending 
on the origin of WT2 programs. 
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4. PROGRAM TAPE GENERATE AND MAINTAIN ORDERS 


a. STG System Tape Generate 
1) Purpose and Operation 


This Order is used to generate the ST. from the Sample ST, 
for a epscific system configuration. The three Orders to 
create a new SP are : 


«Ivf - Initialize 
-TLW - Tape Label Write (on Work Tapes) 
-STG - System Tape Generate (on WI) 


The .STG program adapts the Supervisor to the system 

configuration by: 
« Generating new blocks to bé inserted in the 
Supervisor. 

+ Modifying the BIOS routines contained in the .MTG 
program (on the sample ST), 


The new Supervisor blocks and modified BIOS routines are 
recorded on WT2. Then the .STG generates the ST on WT1 
by duplicating the Sample ST and WT2. 


2) Parameter Cards 
This program requires an Order card, at least five Detail 


cards to define the system configuration, and an End card. 
The required Detail cards are : 


RDC - Mode) of Card Reader 
PRC ~ Model of Printer 

TPC - Type of Tape Controller 
cDpe ~ Type of Card Code 

MCC - Core Store Capacity 
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. STG 
Tf the system includes a Card Punch, an additional Detail card is 
required: 
’ PNC - Model of Card Punch 


The cards are formatted as follows: 


& 
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ORDER CARD 


.8TG 


Recording Density Code 
K = 1600 bpi 
L= 800 bpi 
M= 560 bpi 


Serial number of WT1, if check is required. 
Otherwise blank. 


Not significant. 
Optional ID Code. 
Blank, 


DETAIL CARDS 


RDC ~ (Reader Compile) 


¥RDC 


Model of Reader 
#1 = CRZ100, CRZ111, or CRZ120 


¥2 = CRP100 
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Contents 


Peripheral Unit Name (in decimal), 
Blank if CRZ100, CRZ111 or CRZ?20. . 


Not significant. 


PRC — (Printer Compile) 


YPRc 


Model of Printer 
31 = PRTI00 or PRT110 
2 = PRTM20 or PRT130 
$3 = (to be assigned) 
#4 = (to be assigned) 
$5 = (to be assigned) 


Peripheral Name (in decimal). 
Blank if PRT100 or PRT110. 


Not significant, 


TPC ~ (Tape Compile) 


prrc 


Type of Controller 
#1 = (to be assigned) 
$2 = 7/9 track Controller 
#3 = (to be assigned) 
34 = Phase Modulation Controller 
45 = (to be assigned) 
6 = (to be assigned) 
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Number of tape mits ~ from 3 to 8 (in decimal) 


(fo be assigned) 
(fo be assigned) 
Not significant. 


CDC - (Gode Compile) 


fone 


H (for Hollerith code). 
B (for Bull code). 


Not significant 


Mcc - (Memory Cepacity Compile) 
puec 


Core Store capacity 


Punch 12, 16, 24 or 32. 
7 - 80 | Not Significant 
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PNC - ( Punch Compile) 


bPNC 


Model of Card Punch 


¥1 = CRP100 
W2 = CPZ101 
¥3 = CPZ103 


Peripheral Unit Name (in decimal), 


Not significant. 


END CARD 


BEND 


Not significant 
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3) Condition Checking Messages 


San PT 


Stops at 
TITL 
& and NOTES Address 


Message 
Number 


*UNIT X: PERSISTENT ERROR (read or write) O2A6 

4202 *UNIT X: OUT OF ORDER 
If after rewind command 01DA 
If after read or write command 0246 


If during final rewind, program end normally. 


4010 *UNIT X: SERIAL NUMBER Y WRONG/SHOULD BE N O2A6 
Order card wrong. S/N in cols. 6 - 11 does not match 


S/N in WT1. 
4020 *INVALID DETAIL CARD O2A6 
4027 *ILLEGAL DENSITY CODE (col. 5, Order card) 02A6 
4040 *INVALID PERIPHERAL NAME X 0246 


(cols. 7-9 of RDC, PRC, PNC) 
Name not in decimal or greater than 255. 


4050 *DETAIL CARD MISSING O2A6 
One or more of § cards missing. 


4051 * INVALID CORE STORE CAPACITY CODE 02A6 
(cols. 5 - 6 of MCC card) 


4052 * INVALID PERIPHERAL CODE 0246 
(cols. 5 - 6 of RDC, PRC, TPC, PNC cards) 
4053 * CONFIGURATION NOT ACCEPTED O2A6 


Insertion in Supervisor has been requested 
for a routine not recognized by the .STG 


program. 
*END OF SYSTEM TAPE GENERATE 


I-92 


ETOS PROGRAMMER'S MANUAL 
«STG 


4) Example 


. Problem: To generate a ST on WT1 (previously labelled) 
for following configuration: 
Density Code: 800 bpi 
Reader: CRZ100 
Printer: PRT100 
Tape Controller: 7/9-track, 3 tape units 
Core Store capacity: 16K 


+ Solution: Punch cards as follows: 


1 5 0 Bb 20 2 
Tadd 1 fi 
3 (em L 
‘ 2 | 
Thee Cer 
; | 
8 
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b, .SPD System Tape Print and Duplicate 
1) Purpose and Operation 


This program permits the duplication of the ST (or MT) 
. while printing out the labels of all porgrams in the 
tape. Either printing or duplication is optional, but 
in duplication, programs in Debugging Format Mode (see 
.DPG order) are eliminated. 


The program operates in the following sequence: 


a) The tape(s) are rewound and positioned after the TM's 
following the two Header labels. 


by The ST or MT is duplicated and/or labels are printed. 

ec) If there is an. *in column 8, a TM and trailer label 
are recorded after the S/R Library. If column 8 is 
blank the Type 3 programs are also printed and/or 
duplicated. 


2) Parameter Cards 


. The program uses an Order card only, formatted as follows: 


. Contents 


Execution Type Cade 
% = Duplicate and Print 
D = Duplicate only 
P = Print only 
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W1 = to duplicate on WT1 
W2 = to duplicate on WT2 
W3 = to duplicate on WT3 


Or, Tape Unit Select Number on which duplication 
will be done (1 to 8). 


Program Type Code 


K if Type 3 programas also to be duplicated/printed 
* Otherwise. 


Not significant. 
Optional ID Code, 
Blank. 


3) Condition Checking Messages 


Message Stops at 
Number 2 TrDR ond NOTES Address 
4101 *UNIT X; PERSISTENT ERROR (read or write) O2A6 | 
4102 *UNIT X: OUT OF ORDER 
if after rewind command O1DA 
If after read or write command O2A6 
Tf during final rewind, program ends normally, 
4118 *EXECUTION TYPE CODE WRONG 0246 
(col, 5) 
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*TAPE UNIT CODE WRONG 
(cola 6 - 7) 
Either non-existent unit number, or same unit 
number as ST or MT is mounted on. 


*USER PROGRAM CODE WRONG 
(col. 8) 


*END OF SYSTEM TAPE PRINT AND DUPLICATE 


4) Example 


. .Problem: Duplicate on WT1 the ST, excluding all Type 3. 
programs, 
Print labels. 


« Solution: Punch the Order card as follows: 
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1) Purpose and Operation 
This program is used to eliminate from the ST the Type 3 
programs which are no longer needed. As specified in 
column § of the Order card, the ST will be positioned 
after the 8/R Library, or after the normal Type 3 program 


specified by the user (columns 6 - 13). A TM and the 
trailer label are then recorded and the tape is rewound. 


2) Parameter Cards 


The program uses an Order card only, formatted as follows: 


Contents 


1-4 -8TC 


5 2 = Close ST after S/R Library 
3 = Close ST after a Type 3 program 


6-13 Name of Type 3 program. Used only when ‘3’ in 
col. 5. 

14 ~ 72 Not significant. 

73 - 76 Optional ID Code. 

77 = 80 Blank. 
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3) Condition Checking Messages 
Message Stops at 
Number TITLE and NOTES Address 


*UNIT X: PERSISTENT ERROR (read or write) 


*UNIr X; OUT OF ORDER 
If after read or write command 
Hf during final rewind, program ends 
normally. 


*PROGRAM TX NOT FOUND 
(Xin cols. 6 - 13) 


*ILLEGAL PROGRAM TYPE 
(col; 5) 


*END OF SYSTEM TAPE CLOSE 


4) Example 


- Problem: To close the ST after a Type 3 program. 
Name of program: TEST1L 


« Solution: Punch the Order card as follows 
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ad STU System Tape Update 
1) Purpose and Operation 


This program is used to update the ST by: 


» Writing new, or updating existing program labels 
(see figure 3, page II - 3). 

« Inserting new segments, while deleting pre-existing 
segments from the insertion point up to the end of 
the program, 

e Replacing existing segments. 


The program always eliminates any Debugging Format Mode 
programs (see .DPG Order, page III-63) from the ST. 


2) Parameter Cards 


The program uses an Order card, up to three types of 
Detail cards, and an End card. The Detail cards are: 


PLC — for writing a new, or updating an existing 
program label. 
SIN — for inserting a new segment. 
SRP - for replacing an existing segments 
Each SIN or SRP card is followed by its associated 


program cards, All SIN and SRP cards must be arranged in 
ascending segment numbers. 


Each .STU Order updates one program only, and the 
associated Detail cards must refer to that program, The 
Order may be used in any of the following configurations: 


a) Insert new segment(s) only 
«STU + SIN(s) + END 


bp) Replace existing segment(s) only 
«STU + SEP(s) + END 
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o) Insert new program label 
STU + PLC (with 'I' in col. 36) + END 


a) Insert new program label and segment(s) in program 
«STU + PLO (with 'I' in col. 36) + SIN(s) + END 


2) Replace existing program label 
»STU + PLO (with 'R' in col. 36) + END 


f) Replace existing program label and insert new 
segment(s) in program re) 
STU + PLC (with 'R' in col. 36) + SIN(s) + END 
g) Replace existing program label and existing 


segment(s) in program 
«STU + PLO (with 'R' in col. 36) + SRP(s) + END 


The Parameter cards are formatted as follows: 


ORDER CARD 


«STU 


Not significant. 


Optional ID Code. 


Blank. 
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DETAIL CARDS 


PLC (Program Label Create) 


BPLC 


‘Type (1 or 3) and name of program whose label is 
to be created (new or substitute label). 


Type of BIOS required by program. 


Tf 'I' in col. 36 , type and name of program after 
which new label is to be inserted. If cols. 15 - 
23 are blank, the new label will be inserted 
after all Type 1 or 3 programs (as indicated in 
col. 5). 

If 'R' in col. 36, type and name of program whose 


label is to be replaced. If cols. 15 - 23 are 
blank, the label of the program indicated in 
cols. 5 -13 will be updated without changing 
the program name. 


Initial address of File Table (in hexadecimal). 
If no table, indicate address 0000. 


Initial address of program (in hexadecimal). 


First Core Store location available after end of 
program (in hexadecimal). 


if new label is to be inserted. (In this case, 
the PLC card is normally followed by SIN card(s) 
in order to generate a new program on ST. If no 
SIN card(s); 2 TM is written after the label). 

R if label is to be replaced. 
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37 - 42 Date (BYYDDD) to be inserted in program label. 
Blank if today's date to be inserted. 

43 - 80 Not significant, 


SIN (Segment Insert) 


1 
5 


14 


16 
20 


22 


33 


- 4 
- 13 


- 15 


- 32 


¥SIN 


Type-and name of a program in which new segment is to be 
inserted. If a new program, this field must be the 
Same as that indicated in preceding PLC card, 
cols. 5 - 13. 


Numher of segment after which insertion is to be made. 
00 if it is the first program segment, (If more than 
one segment is to be inserted in the same program, 
they are inserted in sequence since the segment number 
of the first SIN card only is recognized by the .STU 
program). 


Not significant. 


Number to be assigned to segment being inserted (in 
decimal). 


Not significant. 


Indicates quantity of program cards (in decimal) 
used by the preceding SIN card, if any. (To check that 
no program cards are missing as tape is loaded), 

Tf check not required, these columns are blank, 

If first SIN card, these columns are not significant. 

If one SIN card only, or if last one of series, the 
quantity of associated program cards is punched in 
cols. 33 - 36 of END card. 
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Date (/YYDDD). Date on first SIN card only is significant. 
Date on PLC card, if any, overrides this date. 
Blank if today's date is used. 


Not significant. 


SRP (Segment Replace) 


¥SRP 


Type-(1 or 3) and name of program in which the substitution 
is to be made, 


Number (in decimal) of the segment to be replaced. 
Not significant. 


Number (in decimal) of program cards with preceding SRP 
(ifany). This number is checked during tape loading. 
If check is not required, these columns are not 
punched. To check the last SRP, this quantity is 
punched in cols. 33 - 36 of the END card. 


Date (b>YYDDD). Date on first SRP only is significant. 
Date on PLC card, if any, overrides this date. 
Blank if today's date is used. 


Not significant. 


Im-103 


ETOS PROGRAMMER'S MANUAL 


. Stu 
END CARD 
Columns Contents 
4 KEND 
32 Not significant. 
36 Number of program cards with last SEN or SRP card, to 


be checked during tape load. 
Blank if check not required. 


Date (/YYDDD). 
Blank if today's date is used. 
Date on PLC card, if any, overrides thig date. 


Not significant. 


3) Condition Checking Messages 


Message 
Number 


TITLE and NOTES 


*UNIT X: PERSISTENT ERROR (read or write) 


UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 

If during final rewind, program ends 
normally. 


*INVALIDD DETAIL CARD 
Detail card with invalid name or out of sequence. 


*PROGRAM TX NOT FOUND (on ST) 
{cols. 15 - 23, PLC card) or 
(cols. 5 - 18, SIN or SRP cards) 


DU-104 


ETOS PROGRAMMER'S MANUAL 
- STU 


*CARD COUNT WRONG 
(cols. 33 - 36, SIN, SRP, or END cards) 


*MULTIPLE PROGRAM NAME TX 
Program found on ST with same name as program 
to be inserted (PLC with 'T' in col. 36). 
Program is inserted anyway. 


*INVALID PROGRAM NAME 
col, 14 of PLC card wrong, or Detail card 
with different program name (cols. 5 - 13). 
*ILLEGAL PROGRAM TYPE 
*INVALD DATE 
*DATA CARD WRONG 


Incorrect program code, or invalid data 
(on program card). 


* SEGMENT NUMBER X WRONG 
Not in ascending sequence, or invalid. 


*SEGMENT NUMBER X NOT FOUND (on ST) 


*ILLEGAL PLC TYPE CODE 
Neither 'I' nor 'R' in col. 36. 


* END OF SYSTEMTAPE UPDATE 
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- Problem: To insert a new program into the ST as the 


last Type 3 program, 
New program name: PHASES 


Decimal Hexa 
File Table address: 2400 0960 
Initial program address: 2432 0980 
First address after end of 
program: 5696 1640 


Phase} uses data files on tape, and consists of a single segment 
contained in 268 cards. 


Solution: Punch cards as follows: 


1 5 10 uid 20 a » Ky 
7 YlS|T}G 
2| Adel alsi4l igi is] doicioloigia|d vie4lonzi 
5\ |szMseHaisial [st loo| | | | bly ti 
fe eh) Ciclatchs HH an 
272 i | | ee! “4 
Tu | ; 
LETT 
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e. .STS System Tape Strip 


3) 


2) 


Purpose and Operation 


This program is used to remove Type 1 or 3 programs 
from the ST, operating as follows: 


a) 


b) 


c) 


a) 


e) 


f) 


g) 


Position WT1 after the Header labels. 

Read and print Detail cards which specify programs 
to be eliminated from ST. 

Search ST for first program to be removed, 


Transfer contents of ST to WT1, excluding the 
programs to be removed. 


Re-position the ST to the point ahead of the first 
program removed, and transcribe contents of WT1 to ST. 
Print names of programs to be removed which were not 
found on ST. 


Rewind both tapes. 


Parameter Cards 


The program requires an Order card, one Detail card (in 
any sequence) for each program to be removed, and an End 
card formatted as follows: 
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ORDER CARD 


Contents 


-STS 


Not significant 
Optional ID Code. 


Blank, 


DETAIL CARD 


KSTS 


Type (1 or 3) and name of program to be removed. 

C if program to be removed is in Debugging Format 
Mode (see .DPG Order) 

§ otherwise 


Not significant. 


END CARD 


KEND 


Not significant. 
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3) Condition Checking Messages 


Message 
Number 


TITLE and NOTES 


4401 


4402 


*UNIT X: PERSISTENT ERROR (read or write) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 
If during final rewind, program ends 
normally. 


*INVALID DETAIL CARD (cols. 1 - 4) 


*PROGRAM TX NOT FOUND (on ST) 
Card not processed but program continues 


to end, and stops at address 


*INVALID PROGRAM NAME 
(Neither 'C' nor 'b' in col. 14 of Detail 
card for Type 3 programs). 
Card not processed but program continues to 
end, and stops at address 


*ILLEGAL PROGRAM TYPE 
(col. 5, Detail card) 
Card not processed but program continues to 
end, and stops at address 


*END OF SYSTEM TAPE STRIP 
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4) Example 


. Problem: To remove three programs from ST. 
Program types and names: 


1 INT 
1 .»PRL 
3 BILLING 


BILLING is in Debugging Format Mode (. DPG) 
. STS Order belongs to ID sequence A101. 


« Solution: Punche cards as follows: 
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-SLS Subroutine Library Strip 


) 


2) 


Purpose and Operation 


This program is used to remove from one to all S/R's from 
the ST, and to print a new listing(Index) of the remaining 
8/R's. It also updates the S/R Index in the APS Assembler. 
Up to 640 S/R's can be removed. 


It operates in the following sequence; 


a) 


b) 


¢) 


a) 


e) 


f) 


Read and print the Detail cards which specify the 
8/R's to be removed. 


Position WT1 after the Header labels, and the ST ahead 
of the block in the APS Assembler where the S/R Index 
is recorded, 


Update the S/R Index. 


Rewind and duplicate the ST on WT1, removing S/R's as 
required. 


Print new S/R Index to check that all S/R's called for have 
been found and removed. 


Transcribe WT1 to ST and rewind both tapes. 


Parameter Cards 


The program uses an Order card, one Detail card for each 
S/R to be removed (inserted in the deck in any sequence), 
and an End card. If the entire S/R Library is to be removed, 
not Detail cards are required. 
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The cards are formatted as follows: 


ORDER CARD 


Contents 


-SLS 
*If entire S/R Library to be removed. 
B Otherwise 

Not significant. 

Optional ID Code. 

Blank. 


DETAIL CARD 


1-4 ¥#SLS 
5 - 10 Name of S/R to be removed. 
11 - 80 Not significant. 
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END CARD 


1-4 


5 - 80 Not significant. 


3 ) Condition Checking Messages 


* UNIT X: PERSISTENT ERROR (read or write) 


* UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 
tf during final rewind, program ends 
normally. 


INVALID DETAIL CARD 

Error in cols. 1 - 4 of Detail card, or 
End card follows Order card when there is 
a} in col. 5 of Order card. 


SUBROUTINE YX NOT FOUND (on ST) 
Program continues to end but steps at 
address 
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Stops at 
Address 


0246 


TITLE and NOTES 


* EXECUTION TYPE CODE WRONG 
{col. 5 of Order card) 


* INVALID SUBROUTINE NAME 
(cols. 5 — 10 of Detail card) 
8/R name does not begin with Y. 
Card not processed, program continues to, 
end but stops at address 


SUBROUTINE LIBRARY INDEX 
Heading, followed by printout of new 
S/R listing. 
* MAIN SUBROUTINE YX DELETED 
Message(s) specifying name(s) of main 5/R(s) 
calling the S/R that has been deleted, These 
main 8/R(s) are also deleted. 


* END OF SUBROUTINE LIBRARY STRIP 


4) Example 


+ Problem: To remove two S/R's from the ST. 
8/R Names: YPNST, YMULS . 
Order card belongs to sequence A103 


e Solution: Punch cards as follows: 
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g. .SLI Subroutine Library Insert 


NOTE: Refer to the GE-130 APS Programmer's Manual for definitions of 
APS terms used in this Order and identified by quotation marks. 


1) Purpose and Operation 


This program is used to insert a S/R (which has just been 
assembled on WT2 by the . APS Order) into the S/R Library 
on the ST. The program can be subdivided into three phases: 


a) Transfer the S/R from WT2 to WT1, formatting it as 
required (page H-6). 
b) Insert the S/R into the S/R Library. 


c) Update the S/R Index in the "APS Assembler" on the 
sT. 


NOTE: When the .APS Order has been processed, the S/R is on WT2 
with the following format: 


. The S/R is contained in one or more blocks having fixed 
lengths of 695 characters each. 


ss Each block consists of a §-character block number, plus 
five 138-character records formatted as shown below: 


One "APS source instruction", or one of the instructions) 
generated by an "APS source macro-instruction". 


Not significant. 


WWI-115 


ETOS PROGRAMMER'S MANUAL 


SLI 


111 -119 Reserved for error signals. 


120 -121 Length of instruction, or Length (minus 1) of 
areas, or Length (minus 1) of constants. 
(Defined by "DS, "DC" or "DP" instructions). 
122 -125 Instruction address. 

126 -127 Operation code of instruction, 


128 -129 Operation complement of instruction. 
("Duplication factor" for constants and areas). 


130 -133 Address of first operand, or decimal zeroes, 
whichever is applicable. 


134-137 Address of second operand, or decimal zeroes, 
whichever is applicable. 


Decimal zero, 


NOTE: The information in characters 120 - 138 is in unpacked 
binary form. 


The operation of . SLI is as follows: 


a) Position WP1 and WT2 after initial TM. 
b) Process and transfer the S/R to WT1 with: 


. Blocks formatted on WT1 as described in 
page 0-7 except block labels not recorded. 
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e) 


f) 
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Each alphanumeric constant recorded in ‘unpacked 
form", and left~aligned (with blanks to the right 
if the actual length is less than the defined length). 
7 Each hexadecimal constant is translated into 
machine language and right-aligned (with binary 
zeroes to the left if the actual length is less 
than the defined length). 
o Both alphanumeric and hexadecimal constants are 
recorded on WI1 as many times as specified by the 
"duplication factor". 


3 A "DS" instruction closes a block, except when it 
has a "duplication factor" of 0. 


An "ORG" instruction closes a block. 
The "*", "LF" and "EJEC" instructions are ignored, 
Rewind WT1 and WT2. 


Position the ST ahead of the 8/R Index contained in 
the "APS Assembly Program". 


Update the S/R Index. 

Transfer the S/R from WT1 to the ST at the end of the 
S/R Library, recording a block label (figure 6, page 
Il-6), before each block. 


Rewind ST and WTI. 
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NOTE: The date recorded in the block label (field C, figure 6, page II-6) 
is taken by the . SLI program from: 


+» The Comment card, if used after the source card deck and 
before the End card, provided the date is specified in the 
operand field in the form, YNNNNN:..YYDDD. 
(YNNNNN = S/R name, #YYDDD = Date in decimal form). 


+ The day's date in SRA, if the Comment card is not used, 
or if the date is not specified correctly. 


2) Subroutine Programming Restrictions 
a) Instructions must be ordered sequentially. 


b) In "DC" ("ALL") instructions, symbolic addresses are 
not allowed. 


ec) "DC instructions with continuation" are not allowed. 


d) In "ORG" instructions, only the "R operand" is 
allowed. 


e) "RORG" "ESCT" and "ESGM" instructions are not 
allowed. 


£) A S/R name cannot be used as an operand of an instruction 
unless it is called ina "JU" or "JRT" instruction. The S/R 
called must be in the S/R Library. (Note that the .APS 
program will print out a "U" message, to signal that the 
S/R has called another S/R). 


g) The S/R name when used in a "JU" or SRT" instruction 
cannot be modified ("+" or '-"), 


h) S/R's using Conversion Tables must have fixed-length 
names of 6 characters, beginning and ending with "Y". 
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3) Parameter Cards 


‘The program uses an Order card only, formatted as follows: 


Columns Contents 


1-4 ~SLI 

5 - 10 Name of S/R to be inserted. 
ll =~ 72 Not significant, 

73 - 76 Optional ID Code. 

77 - 80 Blank, 


4) Condition Checking Messages 


Stops at 
Address 


Message 


‘LE Ei 
Number TITLE and NOTES 


#UNIT X: PERSISTENT ERROR (read or write) 


4602 4UNIT X: OUT OF ORDER 
If after a rewind command O1DA 
If after a read or write command 

if during final rewind, program ends 
normally. 
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* SUBROUTINE YX NOT FOUND 
S/R to be inserted not in WT2, or the 
S/R called is not in ST, 


4614 *MULTIPLE SUBROUTINE NAME YX 
A S/R with the same name is already in 
the S/R Library. The S/R is not inserted, 


4638 *INVALID LABEL 
Label generated by APS Assembler not 
found in WT2. 

4639 *INVALID SUBROUTINE NAME 


(cols, 5 - 10 of Order card) S/R name 
does not commence with Y. 


4650 *SUBROUTINE ADDRESS WRONG 
The initial address of the S/R is not 
0000. 

4651 *SOURCE STATEMENT WRONG 


A programming restriction has been 
disregarded (see 'Restrictions') 
The wrong instructions are printed, 


*END OF SUBROUTINE LIBRARY INSERT 


5) Example 


Problem: To insert 2 S/R in S/R Library of ST. The 
Order is part of the ID Sequence, PR.1 and the 8/R 


name is YYSDS. 
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Solution; Punch the Order card as follows 
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h. .SPC Subroutine Peripheral Change 


1) 


2) 


Purpose and Operation 


This program is used to change the names of one or two peripheral 
units within one or more S/R's inthe ST. It operates in the 
following sequence: 


a) Read and print all Detail cards (which specify the S/R's 
called for and the old and new peripheral unit names) 


converting the peripheral names to binary. 


b) Position the ST at the beginning of the S/R Library, 
and WT1 after the Header labels, 


c) Transfer the contents of the S/R Library from the ST 
to WT1, changing the peripheral names as specified. 


d) Rewind the tapes to the positions in step (b) above, 
and transfer the contents of WTi to the ST. 


e) Rewind both tapes. 
Parameter Cards 
The program uses an Order card, a Detail card for each S/R 


to be changed (sequenced in any order) and an End card. They 
are formatted as follows: 
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ORDER CARD 


SPC 


Not significant, 


Optional ID Code. 


Blank. 


DETAIL CARD 


1-4 SPC 

5 - 10 Name of S/R to be processed. 
11 - 13 Present name of peripheral to be changed (in decimal) 
14 - 16 New name of peripheral (in decimal), 
17 - 19 Present name of second peripheral to be 

changed, if requires (in decimal). 

20 = 22 New name of second peripheral ( in decimal). 
23 - 80 Not significant. 
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END CARD 


KEND 


Not significant 


*UNIT X: PERSISTENT ERROR (read or write) 


*UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 
If during final rewind, program ends normally. 


*INVALIDD DETAIL CARD 


Error in cols. 1. - 4, or End card after 
Order card, 


*SUBROUTINE YX NOT FOUND (on ST) 
Program continues to the end, but stops 
at address 


*INVALDD SUBROUTINE NAME 
Name does not begin with Y, 
Program continues to the end, but stops 
at address 
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*INVALID PERIPHERAL NAME X 
Name not in decimal, or greater than 
255. Program continues to end, but 
stops at address. 


*SUBROUTINE YX PERIPHERAL Z NOT FOUND 


S/R (cols. 5 - 10 of Detail card) does not 
contain peripheral specified. 

Program continues te end, but stops at 
address. 


*END OF SUBROUTINE PERIPHERAL CHANGE 


4) Example 


Problem: To change the name of the Card Punch. 
S/R name: YP85 

Present name of Punch: 048 

New name of Punch: 064 


Solution: Punch cards as follows: 
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i = .LTU = Library Tape Update 


1) 


Purpose and Operation 


This program is used to generate a new LT or to update an existing 
one, as follows: 


a) Insert programs from the ST into the LT, with or without 
modifying the File Table, 


b) Remove programs from the LT. 
c) Update the File Tables of existing programs. 


In processing, the new LT is recorded on a separate tape, leaving 
the old LT intact for future reference. 


The program is in three segments, operating as follows: 
First Segment (Read and Store Detail cards) 


a) Update the LT creation and purge dates, recording 
today's date and the same date plus three years, 
then printing the labels, VOLI1 (or INT1) and HDR1. 


b) Read the Detail cards and store them in a tabie. 
In case of table overflow, a message is printed 
specifying the last card accepted. The remaining 
cards are not processed, 


ec) fa new LT is to be created ( in col. 5 of Order card) 
start third segment. If not, start second segment. 


. Second Segment (Update existing LT) 


a) Check for PRL (see page If-128) in the table. If none, 
rewind ST. If present, transfer those programs that are 
to be inserted at the beginning of the LT from the ST to 
the updated LT. 
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b) Read first program label in the existing LT and check for the 
presence of corresponding Detail cards in the table. If none, 
transfer that program to the updated LT. If present, proceed 
to one of the following steps. 


c) If the program name is on a PRI card (cols. 5 - 12) transfer that 
program to the updated LT. 
Immediately following this program, insert the new program 
which has been transferred to the updated LT from the ST. 


da) If the program name is on a PRT card, (see page [-128) transfer 
that program to the updated LT and update the File Table of the 
transferred program as required. 


e) if the program name is on a PRM card (see page II-128), it is not 
transferred to the updated LT. 


f) Subsequent program in the old LT are processed as described to 
the updated LT. 


g) After all program labels have been processed and Detail cards 
remain in the table for programs not found, print out the program 
names under message number 4808. 


‘Third Segment (Create new LT) 


Only those programs called for by PRI cards are recorded on the 
new LT, in the same sequence in which the cards are read. 
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2) 


Parameter Cards 


The program uses an Order card, three types of Detail cards 
(described below) and an End card, 


PRI (Program Insert) is used to insert a program from the ST. 
If the File Table of that program is to be modified, the PRI 
is followed by LBC cards which contain the information 
required for this purpose. 


PRT (Program Transfer) is used to modify the File Table 
of an existing program in the LT. It is always followed 
by LBC cards, 


PRM (Program Remove) _ is used to eliminate a program 
from the LT. . 


To create a new LT, use only PRI cards (with LBC cards if applicable). 
To update the existing LT, all three types if Detail cards may he used 
(with LBC cards, if applicable). 


LBC cards are described in various Orders. The other cards are 
fromatted as follows: 
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ORDER CARD 
-LTU 
5-6 W1 if existing LT is WTI. 


W2 if existing LT is WT2. 

WS if existing LT is WTS, 

Or the Select number of unit containing the existing 
LT (1 to $8). 

*in col.5 if generating a new LT. 


7-8 Same as cols. 5 -6, but referring to updated or 
new LT. 

9-14 Serial number of tape specified in cols. 5 - 6, if 
checking requested. 


Otherwise, blank. 

15 - 20 Serial number of tape specified in cols, 7 - 8, if 
checking requested 

Otherwise, blank. 

21 - 72 Not significant. 

73 - %6 Optional ID Code. 


Blank, 
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DETAIL CARDS 


PRI Card 


PRI 


Name of program on existing LT preceding program to be 
inserted. 

Blank if program is to be inserted at the beginning of the 
updated LT, or if creating a new LT ( in col. 5 of 

Order Card). If updating LT, the first PRI card 

only may have blanks in cols. 5 - 12). 


13 - 20 


Name of program to be inserted (from ST). 


Not significant. 


PRT Card 


PRT 


Name of program in LT containing File Table to be 
modified. 


Not significant. 
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PRM Card 


BPRM 


Name of program to be deleted from LT. 
Not significant 


END CARD 


KEND 
Not significant, 


3) Condition Checking Messages 


TITLE and NOTES 


UNIT X: PERSISTENT ERROR (read or write) 


Stops at 
Addres: 


Message 
Number 


#UNIT X: OUT OF ORDER 
If after rewind command 
If after read or write command 

If during final rewind, program ends 

normally. 


*INVALID DETAIL CARD 
. Name incorrect (cols, 1 - 4) 
. The End card follows immediately 
after the Order card. 
. The Detail cards are not in the 
proper sequence, 
. LBC card(s) not following the PRT card, 


4808 * PROGRAM TW NOT FOUND 

(on ST or LT) 

Program continues to end but stops at 
address 
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Message 


Number TITLE and NOTES 


*UNIT X: SERIAL NUMBER Y WRONG/ SHOULD BE Z 02A6 


*UNIT X: HDR1 LABEL NOT FOUND 0246 
{on new or updated LT) 


*DETAIL CARD OVERFLOW/X LAST CARD 
Program continues and processes only 
the accepted Detail cards. At the end it O2A6 
stops at address. 


*INVALID PROGRAM NAME 02A6 
Name in LEC card different from name 
in PRI or PRT card. See NOTE at end 
of Table. 


*TABLE UNIT CODE WRONG O2A6 
(cols. 5 - 6 and/or 7 - 8 of Order card). 


*MAIN UNIT CODE ERROR 02A6 
(col. 48 of LBC card). See NOTE at end 
of Table. 


* ALTERNATE UNIT CODE ERROR O2A6 
(col, 44 of LBC card). See NOTE at end 
of Table. 


*ILLEGAL DENSITY CODE O02A6 
(col. 51 of LBC card). See NOTE at end 
of Table. 


T-132 


ETOS PROGRAMMER'S MANUAL 


«LTU 


Message 
Number 


Stops at 


TITLE and NOTES Address 


“IDENTIFICATION FILE CODE X NOT FOUND 
(In File Table to be updated). 
LBC card is not processed but program 0246 
continues to end and stops at address 


4829 *INVALID DATE O2A6 
(cols, 37 - 42 of LBC card). 
See NOTE at end of Table, 


4834 *INVALID FILE CHECK OPTION CODE 02A6 
(cols, 45 - 50 of LBC card). 
See NOTE at end of Table. 


4838 * FILE TABLE NOT FOUND 
Related program is recorded on LT anyway. 02A6 
At the end, the program stops at address 


4879 * LIBRARY TAPE INDEX 
This message is followed by a listing of 
programs on new or updated LT. 


4899 *END OF LIBRARY TAPE UPDATE 


NOTE: When error is in LBC card, program checks the other LBC cards 
then stops at address 02A6. 
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4) Example 


Problem: To insert a new program in the LT, 

Follows program : INVTY.A 

New program name: INVTY. /B 

Existing LT is mounted on Unit 3 

New LT to be written on WI2 

Checking of tapes not required 

File Table of new program does not require modifcation. 


Solution: Punch cards as follows: 
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je MIG Master Tape Generate 


1) 


Purpose and Operation 


This program is used to generate a MI, taking Type 7 
programs from the ST and Type 3 programs from the LT. 
The following Type 1 programs are always inserted: 


Supervisor 

eINT (Initialize) 

«PRL (Program Load) 
»MIS (Master Tape Stop) 


To allow the system to operate in MIM (Master Tape Mode), 
the Supervisor, »INT, «PRL, and each Type 3 program are 
modified as follows: 


a) In the Supervisor, Pilot 1 is altered so that, before 
reading an Order card, it checks the MI Control Area 
in SRA. 


pb) In .INT all references to ST are changed to MI. 


c) Before loading a program from the MT, »PRL changes 
the jump instruction address in the Re-entry area of 
SRA, from Pilot 0 to Monitor. Thus, after its 
execution, the program transfers control to its 
Monitor instead of to Pilot 0. 


d) On each Type 3 program, segment 00 is added to the 
beginning, and segment 99 is appended to the ends 
Segment 00 contains the BIOS routines required for 
that program, plus the following optional routines 
which are used to preset the program for execution: 
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- Load data in the USDA. 


« Load hexadecimal 'OA' in the Core Store area 
available to the user program. 


« Execute 'HLT' before processing the program. 
Segment 99 is the Monitor, used to load and start the 
next program. It may perform one of five functions, 
depending on the needs of the programmer. These are 
specified in the routing code (the first character of 
the Monitor) by a value from 1 to 5. The format of the 


Monitor is shown in figure 9 , page II- 41, and 
its operation is described in page UII - 17, 


If required, the .M?G Order also can update the File 
Table of each Type 3 program by using LBC Detail cards. 
The .MIG program operates as follows: 
a) Transfer the following Type 1 programa to the MI: 
« Supervisor (with Pilot 1 modified), 
. INT (with references changed to MT). 
. PRL (with jump instructions changed). 
‘ All Type 1 programs requested on OPC Detail cards. 
. MfS program. 


>) Transfer the required Type 3 programs to the MT, as 
follows: 


Read a UPC Detail card and search the LT for the 
requested program. 


TII=136 


Oo 


2) 


ETOS PROGRAMMER'S MANUAL 


e Generate segment 00, using a segment attached to 
. MTG and the parameters specified in the UPC card. 


e) If LBC cards are used, update the Type 3 program File 
Table. 


d) ‘Incorporate the proper BIOS routines in segment 00 of 
each Type 3 programs, as specified in character 10 of 
the Type 3 program label (figure 3, page II-3). The BIOS 
routines are recorded in a segment of the .MTG program, 
which was previously preset by the .STG program. 


e) Transfer the Type 3 program from the LT to the MT. 


f) Generate the Monitor by using a segment of . MTG and 
the parameters specified in the PRE Detail card. 


Parameter Cards 


The program uses an Order card, four types of Detail cards, 
and an End card, The Detail cards and their functions are as 
follows: 


OPC (Operating System Program Call) is used to insert a 
Type 1 program into the MT. (Note that the Supervisor, 
. INT, . PRL, and .MTS are inserted automatically). 


UPC (User's Program Call) is used to insert a Type 3 


program. 


PRE (Program End) is used to preset the Monitor for each 
Type 3 program inserted. It follows immediately after a 
UPC card, or after the LBC cards used with the UPC. 
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sega Tl 


—— Tl 
| 


°MTE 


ORDER CARD 


»MTG 


W1 if LT is Wr1. 
W2 if LT is WT2. 
WS if LT is WT3. 
Or the Select number of unit containing the LT 


(1 to #8). 
Unit containing MT, identified as in cols. 5 - 6. 
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Serial Number of LT if checking is desired. 
Otherwise, blank. 


Serial number of MT is checking is desired. 
Otherwise, blank. 


Not significant. 


Optional ID Code. 
Blank. . 


DETAIL CARDS 


OPC Card 
YOPC 
Name of Type t program to be inserted. 
Not significant; 


UPC Card 
‘UPC 


Name of Type 3 program to be inserted. 
Not significant. 


Used for segment 00 generation. 
H if HLT is to occur before starting program. 
Otherwise, blank. 


Memory loading code used for segment 00 generation. 
¥ if Core Store area available to user is to be 

set to hexadecimal 'OA' before starting program. 
* if otherwise. 
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Used for segment 00 generation 

* if data to be loaded in USDA before starting 
program. 

} if otherwise, 


Data to he loaded in USDA if in col. 17. 
Not significant. 


LBC Card 


Since these cards are used by other Orders as well, 
they are described in Appendix D. in this Order, 
one LEC is used for each data file, ifany, ofa 
Type 3 program if the associated File Table is to 
be modified, 


PRE Card | 
1-4 KPRE 


5-12 Name of program to which Monitor belongs. (Same 
name as given in cols. 5 - 12 of preceding UPC 
card). 


13 Monitor Routing Code: (values 1 to 5) 


1. Load and start the program specified in cols. 
14-21. 


2. Load and start one program selected by setting 
of SWITCH 2, between the two programs specified 
in cols. 14 - 21 and 22 - 29. 
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3. Read an Order card. 

4, Execute .MTS (Master Tape Stop). 

5. Load and start program specified by the program to which 
Monitor belongs, 


14-21 If'l' in col. 13, name of program to be started 
next, 

If '2' incol. 13, name of program to be started 
with SWITCH 2 off. 


22-29 If '2' in col. 13, name of program to be started 
with SWITCH 2 on, 


Not significant, 


END CARD 


KEND 


Not significant. 
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Message Stops at 
TITLE and Ni P 
Number ane NOTES Address 
4901 *UNIT X: PERSISTENT ERROR (read or write} 
4902 *UNIT X: OUT OF ORDER 
If after a rewind command OLDA 
If after a read or write command 02A6 
Tf during final rewind, program ends 
normally, 
4906 *INVALID DETAIL CARD 02A6 
4908 *PROGRAM TX NOT FOUND 02A6 
Program indicated in cols. 5 - 12 of 
OPC or UPC eard not in ST or LT. 
4910 *UNIT X: SERIAL NUMBER Y WRONG/SHOULD BE Z 0246 
Serial number of LT or MT not the same as that 
indicated in cols. 9 - 14 or 15 - 20 of Order card. 
4920 *INVALD PROGRAM NAME 0246 
Name indicated in LBC or PRE different from that 
in preceding UPC card. 
4923 *TAPE UNIT CODE WRONG 02A6 
(Order card, cols. 5 - 6 for LT, 
cols. 7 - 8 for MT) 
4924 * MAIN UNIT CODE WRONG O2A6 
(col. 43 of LBC card) 
see NOTE at end of Table. 
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4925 *ALTERNATE UNIT CODE WRONG 02A6 
(col. 44 of LBC card) 
See NOTE at end of Table 


4926 *ILLEGAL DENSITY CODE O2A6 
(col, 51 of LBC card). See NOTE at end 
of Table, 


4928 *FILE IDENTIFICATION CODE X NOT FOUND 02A6 
File indicated in cols. 13 - 18 of LBC 
eard not in program's File Table. 


4929 *INVALD DATE 02A6 
(cols. 37 - 42 of LBC ecard). 
See NOTE at end of Table. 


4931 *USER DATA CODE WRONG 02A6 
{col, 17 - UPC card) 


4932 *MEMORY LOADING CODE WRONG 02A6 
(col. 16 - UPC card) 
4933 *HALT CODE WRONG 0246 


(col. 15 - UPC card) 


4934 *INVALID FILE CHECK OPTION CODE O2A6 
(cols. 45 - 50, LBC card). 
See NOTE at end of Table. 


4937 *FILE TABLE NOT FOUND 

Program indicated in LBC card has no File 
Table. This message printed after message 
4906. 
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4950 


4951 


NOTE: 
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*MONITOR ROUTING CODE WRONG 
(col. 13 - PRE card) 


*MONITOR PROGRAM TABLE OVERFLOW O2A6 
Insertion on MT requested for more than 
77 programs ( the maximum number of program 
names that can be recorded in Field F of 
Monitor, see Figure 9, page IJ-11). 
However the MT is closed normally after the 
programs that have been inserted up to 
this point. 


*END OF MASTER TAPE GENERATE 


When error is in LBC card, the program finishes checking that 
card, before stopping at address 02A6. 


4) Example 


7 Problem; To record MT on tape unit 3, containing: 
Type 1 programs: .TDP and .CRD 
Type 3 programs: PROGKA 
PROGSB 
PROGHC 


Preset PROGKC to load user data in USDA. 

Precede PROG#B and C with a HLT. 

After PROGKA execute PROGHB with SWITCH 2 on or PROGKC 
with SWITCH 2 off. 

After PROGKB execute PROGKC. 

After PROGKC read an Order card. 

LT mounted on tape unit 2 with serial number XC0003. 

MT serial number: YN0013. 
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Solution: Punch cards as follows: 


_ 

: 

he 
fees et 
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k. .BPR Basic Program Replace 


1) Purpose and Operation 


2) 


This program is ysed to duplicate the ST, replacing one 
or more blocks in the Supervisor. The program operates 
as follows: 


a) Duplicate ST up to the block to be replaced, as 
indicated in column 5 of BRP Detail card. 


b) Insert the block contained in the Program cards 
following the BRP card. ‘ 


c) Repeat steps a and b for all blocks to be replaced. 


d) Complete ST duplication then rewind orginal and 
updated ST. 


Parameter Cards 
The program uses an Order card, one or more BRP Detail 


cards, Program cards are required, and an End card, 
formatted as follows: 
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ORDER CARD 
Columns Contents 
1-4 . BPR 
5-6 Wi = if new ST is WT1 
W2 = if new ST is WT2 
W3 = if new ST is WT3 
Or Select number of tape unit containing new ST 
(Bt to #8). 
qT Recording density code: 
K = 1600 bpi 
L= 800 bpi 
. M= 556 bpi 
8 -13 Serial number of tape to be recorded, if check 
desired. 
Otherwise, blank. 
14-72 Not significant. 
73 - 76 Optional ID Code. 
17 -80 Blank. 


DETAIL CARD 
ee 


1-4 bBRP (Block Replace) 
5 Number of block to be substituted. 
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Number of program cards containing the block to be 
substituted, if check desired, 
Otherwise, blank 


Not significant. 


END CARD 


1-4 ¥END 
5 - 80 Not significant. 


3) Condition Checking Messages 


Stops at 
Address 


Message 
Number 


5001 


TITLE and NOTES 


*UNIT X: PERSISTENT ERROR (read or write) 


5002 


*UNIT X: OUT OF ORDER 
Tf after rewind command OLDA 
If after read or write command 02A6 
If during final rewind, the program ends 

normally, 


*INVALD DETAIL CARD 
(cols. 1 - 4, BRP card) 


5006 
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*UNIT X: SERIAL NUMBER X WRONG/SHOULD BE N | 0246 
Serial number of tape being recorded is 
different from that given in Order card. 


*CARD COUNT WRONG 
(cols. 6 - 9, BRP card) 


*TAPE UNIT CODE WRONG 
(cols. 5 - 6, Order card) 


*ILLEGAL DENSITY CODE 
(col. 7, Order card) 


*DATA CARD WRONG 
Program card has characters uot in hexadecimal, 
or a program code different from first card of 
the block. 


* BLOCK LENGTH WRONG 
Last program card exceeds.maximum block length 
of 4096 characters. 


* BLOCK NUMBER WRONG 
(col. 5, BRP card) 


*INVALID DATA CARD ADDRESS 
Program card with address less than first 
card of the block. 


*END OF BASIC PROGRAM REPLACE 
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4) Example 


+ Problem: To replace the first block of the Supervisor. 
Record new ST on WT2 at 556 bpi. 


+ Solution: Punch cards as follows: 
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1, .LPD Library Tape Print and Duplicate 
* 


1) 


Purpose and Operation 


This program permits the duplication of the LT while 
printing out the labels of all programs in the tape. 
Either duplicating or printing is optional. 


LT to be duplicated/printed is WT1. 
Duplicated LT (if applicable is WT2. 


The program can also be used to adapt an LT generated by 
the GE-115 under TOS (Tape Operating System), for operation 
under ETOS. 


The program operates in the following sequence: 


a) The tape(s) are positioned after the TM following the 
two Header labels, 


b) The LT is duplicated and/or labels are printed, 


c) When duplicating a 115-generated LT (asterisk in column 6 
of Order card), the code recorded in character 10 of each 
program label to specify the type of GE-115 BIOS, is 
converted into the applicable code for ETOS (as shown in 
field C of figure 3, page II-3). 


NOTE: In duplicating each two consecutive blocks in the 
same segment, they are consolidated in one block, 
with maximum length increased from 2048 
characters to 4096 characters, on tape. 


I-150.1 
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2) 
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Parameter Cards 


The program uses an Order card only, formatted as 
follows: 


Contents 
«LPD 


¥ to duplicate and print 
Dto duplicate only 
Pto print only 


¥ to duplicate GE-130 LT 
to generate GE-130 LT from GE~115 LT 


Not significant 
Optional ID Code. 
Blank 
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3) Condition Checking Messages 


Stops at 


TITLE and NOTES Address 


*UNIT X: PERSISTENT ERROR (read or 
write) 


*UNIT X: OUT OF ORDER 
If after rewind command 
if after read or write command 
Tf during final rewind, program ends 
normally. 


* EXECUTION TYPE CODE WRONG 
(col. 5, . LPD card) 


*LIBRARY TAPE CODE WRONG 
{col.6, . LPD card) 


+END OF LIBRARY TAPE PRINT AND 
DUPLICATE 


4) Example 


Problem: To generate a GE-130 LT from a GE-115 LT, 
to permit operation under ETOS. Print out the LT 
thus obtained. 


. Solution: Punch the following Order card: 
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m. LTM Library Tape Merge 


1) 


Purpose and Operation 


This program is used to record on one LT either all or part 
of the programs contained in another LT. The programs 

to be recorded are added after those already contained in 
the LT. The LT from which the programs are to be 
transferred is assigned as WT1 by the . INT Order, and the 
other LT is assigned as WT 2. 

The program operates in the following sequence: 


a) Position WT1 at beginning of tape and WT2 after last 
program. 


b) Read the Detail cards (if # in col. 5 of Order card), 
specifying the programs to be transferred from WT1 
to WT2. 


e) The programs specified by the Detail cards (if # in 
col. 5 of Order card), or all the programs (if in 
col. 5), are transferred frol WT1 to WT2, in the same 
sequence in which they are recorded on WT1. 


NOTE: The two LT's may have been generated by the 
GE-115 under TOS (Tape Operating System). 
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«LT 


2) Parameter Cards 


The program uses an Order card, one Detail card (LPI) for 
each program to be transferred and an End card, If entire. 
program library is to be transferred, no Detail cards are 
required. They are formatted as follows: 


ORDER CARD 


Contents 


-L™ 


* if entire program library on WT1 is to be transfer] 
red.to WT2. 

¥ if programs to be transferred from WTt to WT2 
must be specified by Detail cards. 


Not significant. 
Optional ID Code. 
Blank. 


DETAIL CARD 


LPI (Library Program -Insert) 


¥ LPI 
Name of program to be transferred. 


Not significant. 


¥ END 
Not significant. 
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.*) 


3) Condition Checking Messages 


TITLE and NOTES 


Message 
Number 


5401 * UNIT X : PERSISTENT ERROR (read or write) 

5402 UNIT X : OUT OF ORDER 
If after a rewind command o1mDA 
If after a read or write command 0286 


If during final rewind, program ends 
normally. 


se 0 


5406 \* INVALID DETAIL CARD 

Name incorrect (cols.t-4), or Order 
card, with * in col.5, not followed by 
End card, or Order card, with $ in col.5, 
followed by End cards 


5408  |* PROGRAM 3X NOT FOUND (on WT1) 
Program continues to end but stops at 
address 


0246 *) 


5413 MULTIPLE PROGRAM NAME 3X 
Program found on WI2 with same name as 
program +o be inserted. Program is 
inserted anyway. LIM program continues 


to end, then stops at address 0246 


0246 (*) 


5418 * EXECUTION TYPE CODE WRONG * 
(col.5, LIM card) 


5419 * DETAIL CARD OVERFLOW cor 
Available Core Store area cannot contain 
entire list of programs. Program 
continues to process only the accepted 
Detail cards. 

At the end it stops at address 


5499 * END OF LIBRARY TAPE MERGE 
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4) . Bxample 


. Problem: To insert all programs of LT1 after the 
programs on LT2. 


- Solution: Punch the following Parameter cards: 


NOTE: LT and LT2 were previously defined as WT and 
WT2 respectively, by the: .INT Order. 
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ne e@PU ST Program Update 


1) 


Purpose and Operation 


This program is used to generate a new System Tape 
on WP2, by inserting in the current ST new and/or 
updated programs from another ST on WI. 


The program consists of five segments, operating as 
follows: 


«Segment 1 (Read first Detail card and call appropriate 
seements) 


a) Rewind WI1 and WI2 and check labels (if requested) 
b) Print WI2 header labels, 


c) Read first Detail card: 
If END card, call Segment 2, 
If OSR followed by END card, call Segment 3. 
Otherwise, call Segment 4. 
Block read/write area is wmique and occupies 
4096 Gore Store locations. 


Segment 2 
Duplicate current ST on WI2 


«Segment 3 (Replace Operating System) 

Generate new ST on WI2, by copying type 1 programs 
(except for Supervisor) and S/R library from WI, 
Supervisor and type 3 programs from ourrent ST, 
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«Segment 4 (Read and store Detail cards) 


a) Read the Detail cards and store them in a table. 
If table overflow occurs a message is printed out 
specifying the last card accepted. In this case, 
processing can be completed by calling the Order 
program again and using WI2 as the current ST and 
the excess Detail cards. 


Note that each run can process up to: 
50 Detail cards using cols. 1-22, or 
90 Detail cards using cols. 1-13. 


b) Check Detail cards. If no errors are detected, 


call Segment 5, otherwise complete checking until 
the END card. 


«Segment 5 (Update current ST) 
a) Rewind ST and check labels (if requested). 
b) Copy Supervisor from ST to WT2. 


c) Copy, update or insert type 1 programs 
from ST or WT1, 


a) Print labels of programs recorded on WT2 
specifying their origin (either ST or WT). 


e) While recording type 1 programs on WT2, store 
their names in a table in Core Store, testing it 
each time to avoid inserting a program twice. 


This table can hold up to 188 names. 
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NOTE: 


f) 


8) 


h) 


i) 


i) 


k) 
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While reading WI1, store in a table the names 
of the programs encountered. Thus search time 
for a given program on tape is reduced by 
executing a backward search if the program is 
referenced in the table, or otherwise a forward 
search. 


This table can hold up to 188 names. 
Before recording the $/R library rewind WM 
and insert in WI2 the other type 1 programs, 


if any, whose position on WI2 was not specified. 


Insert the 8/R library from WI, if the -APS 
program was replaced, otherwise from ST. 


Copy, update or insert type 3 programs, as 
described for type 1 programs. 


Print the unprocessed Detail cards 
(see message 5941). 


Rewind tapes. 


As a result of errors or unprocessed Detail cards, 
programs on WI2 are erased and further recording 
is inhibited, but processing continues to the end, 
to complete error checking. 
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2) Parameter Cards 


The .TPU program requires an Order card, up to four 
types of Detail cards (described below) and an End 
cards 


PIN (Program Insert) is used to insert a new program 


from WT1. 


PRR (Program Replace) is used to replace a program on 


ST with an updated version on WI. 


PRD (Program Delete) is used to delete a program or 


a@ series of consecutive programs on ST. 


QSR (Operating System Replace) is used to replace the 


Operating System on ST (except for the Supervisor) 
with an updated version on WT. 


The Parameter cards are formatted as follows: 
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ORDER CARD 


Contents 


oTPU 


Serial number of current ST, if checking requested. 
Otherwise, blank. 


Serial number of WI1, if checking requested. 
Otherwise, blanke 


Serial number of new ST (W?2), if checking requested, Q 
Otherwise, blank. 


Not significant. 


Optional ID Code. 


Blank *) 


DETAIL CARDS 


1-4 |% PIN 


5-13 |Type (1 or 3) and name of program to be transferred from 
WI1 to WE2. 


14 - 22 |Pype (1,2 or 3) and name of program on ST, which must be 
followed by the program specified in cols. 5 - 13. 

If 1BASICPRG, insert program after Supervisor. 

If 2BASICSUB, insert program after S/R library. 

If all blanks, insert program at the end of the programs 
of the same type (see 001.5); the sequence of program 
insertion is the same as programs are recorded on WI. 


23 - 80 |Not significant 
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NOTES: The PIN card cannot be used to ingert the Supervisor 


(1BASICPRG), the .APS program and the S/R library 
(2BASICSUB). 


Two or more consecutive programs oan. be transferred by 
using several PIN cards. (See example in page III-150.18). 


Contents 


Type (1 or 3) and name of program on ST to be replaced 
by program on WI1 having same name. 


Location of updated program on WT2, relative to other 
programs, will be the same as on the original ST. 


Not significant. 


NOTES: If the program to be replaced is .APS, the 8/R library 
(2HASICSUB)' algo is replaced: it is not allowed to 
specify explicitly the substitution of 2BASICSUB. 


The example in page III-150.18 shows how to insert 
several consecutive programs (using PIN cards) after 
the program to he replaced. 


IIT-150.13 Add. Nov. 1969. 


ETOS PROGRAMMER'S MANUAL 


.*) 


Columes Contents 


}PRD 


5 - 13 | Type (1 or 3) and name of program not to be transferred 
from ourrent ST to WI2. To delete a sequence of 
adjacent programs, punch type (1 or 3) and name of first 
program in sequences 


14 = 22 | Blanks, to delete one program only. To delete a sequence 
of adjacent programs, punch type (1,2 or 3) and name of Q 
program following the last of the sequencee To delete ' 

a@ sequence of type 1 programs, starting from the one 

specified in colums 5—13 up to the beginning of the 

8/R library punch "2BASICSUB", To delete a sequence of 

type 3 programs, from the one specified in columns 5-13 

up to the end of the tape, punch nine exclamation 


points (!). 
oO 


NOTES: The PRD card cannot be used to delete the Supervisor 
(1BASICPRG), the .APS program or the S/R library (2BASICSUB). 


One or more consecutive programs can be transferred from 

WI and inserted after the program specified in cols. 14-22, 

by using PIN cards.A PRD and a PIN card can be used to 

change the originalposition of a program. 0 
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Contents 


5 - 80] Not significant 


NOTES: The OSR card is used to copy to Wi2: all type 1 programs 
(not including the Supervisor) and the s/r library fron 
WI1, Supervisor and type 3 programs from current ST. 


END CARD 


Contents 


% END 


Not significant 


NOTE : If END card immediately follows .TPU card, ST is only 
duplicated on W22. 
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3) Condition Checking Messages 


Stops at 
address 


TITLE and NOTES 


Message 
Number 


5901 


* UNIT X : PERSISTENT ERROR (read or write) 0246 


5902 * UNIT X: OUT OF ORDER 


If after rewind command O1DA 
If after read or write command O2a6 
If during final rewind, program ends 
normally 
5905 * PROCEEDING IMPOSSIBLE 0246 ®) 


5906 % INVALID DEPAIL CARD 

Name incorrect (cols. 1-4): 

Program checks the other Detail cards. 
At the end, message 5905 is printed out 


and program stops at address O2K6 fe) 
5908 * PROGRAM TX NOT FOUND 02:6 
(on ST or WI) 
5910 * UNIT X : SERIAL NUMBER X wRone/ 0246 
SHOULD BE ¥ 
5913 * MULTIPLE PROGRAM NAME TX 
Program to be inserted is already present a) 
on ST 


5919 * DETAIL CARD OVERFLOW/X LAST CARD 
Program continues and processes only the 
accepted Detail cards, then stops at 
address 0246 
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eee 
5921 * ILLEGAL PROGRAM TYPE 

(cols. 5 and/or 14 of Detail cards) 

Program checks the other Detail cards. 

At the end, message 5905 is printed out 

and program stops at address O2A6 


5941 * DATA CARD WRONG o2A6 
Followed by printout of incorrect card. 


5979 * SYSTEM TAPE INDEX 
Followed by list of programs on new 
System Tape. Either of the following 
specifications may appear. 
- DUPLICATE 

duplication from ST to W22 was requested. 
~ DUPLICATE: PROGRAMS TYPE 1 AND 2 

FROM WI1 AND PROGRAMS TYPE 3 FROM ST 

If replacement of Operating System 

was requested. 


* END OF ST PROGRAM UPDATE 
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4) Example 


+ Problems 


Current ST 


(BASICPRG 
1A 

1B 

1.APS 

1¢ 

1D 

AL 

1M 
2BASICSUB 
3P 

3@ 

3R 

3T 

3Y 
seergigyt 
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To generate a new System Tape from the 
following input tapes: 


wt 


1BASIGPRG 
41 

1B 

1.4PS 

1H 

15 

1w 

1K 

AL 

iF 

IT 
2BASICSUB 


32 
SORES E EE: 


Delete programs 1A, 1C, 1D, 3P and 3 
Replace programs 1.4PS, 1L and 3R. 


Insert the following programs: 

- 1E, after Supervisor 

- 1F, 11, 1N, sequentially after program 1L 
- 1K and 1H, after all type 1 prograns 

- 36, after S/R library. 


Invert positione of 1.APS and 1B programs. 
Checking of tape serial numbers not required. 
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+ Solution: Punch cards as follows: 


>| 
a) 
w 


a 


PATRAS c 
ita 


T= 
2. 
|_| 


~ 
oS 
emi Ths TRS 
ea 


aN 


NOTE: Sequence of Detail cards is irrelevant, except 
when the position of a program must be changed. In 
this case the sequence of Detail cards must conform 
to the logical sequence of operations (i.e. first a 
PRD, then a PIN card), otherwise message 5913 would be 
printed out. 
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The following listing shows the sequence of programs 
on the new ST (WI2) and the origin of each: 


Wwr2 Origin 

1BASICPRG 38r 

1E WI1 

1.APS wri 

1B wrt 

1L WE Q 
iF Wr 

iI wri 

IN... wri 

1M ST 

1K wrt 

1H wri 

2BASICSUB wrt 

Er wrt i) 
3k wrt 

32 st 

3x 8T 


STEERED 
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.CMT 
5, OTHER ORDERS 


a, .CMT Comment 
1) Purpose and Operation 


This Order is used to print a one-line comment contained 
in the Order card. 


2) Parameter Cards 


The program uses an Order card only, formatted as follows: 


.CMT 


Comments, 


Optional ID Code. 


Blank. 
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-HLT 
b. HLT Halt 
1) Purpose and Operation 
This Order is used to stop processing. When the Order 
is used, Pilot 1 stops at address 01D6. Pressing START 
restarts Pilot 0 and another Order card is read. 


2) Parameter Cards 


The Order uses an Order card only, formatted as follows: 


gia 


HLT 


Not significant, 


Optional ID Code. 


Blank. 
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G. -MTS Master Tape Stop 


1) Purpose and Operation 
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.MTS 


This Order causes a HLT at address 01D6 and rewinds the MT. 


Pressing START restarts Pilot 0, 


2) Parameter Cards 


The Order uses an Order card only, formatted as follows: 


Contents 


-MTS 

Not significant 
Optional ID Code. 
Blank. 


8) Condition Checking Messages 


Message 
Number 


TITLE and NOTES 


UNIT X: OUT OF ORDER 
Followed by message 6084 


MASTER TAPE STOP 
Press START to restart Pilot 0. 


Stops at 
Address 


1-153 


RST 
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dad. .RST Restart 


y 


Purpose and Operation 


This Order is used to resume a given program from a pre- 
determined point. The restart point (Check point) is requested 
by the CHKP macro-instruction and recorded on any standard 
file only on 9-track tape. It is formatted as follows: 


a) Tape Mark. 


b) Label containing Check point sequence number and 
restart address. 


ce) Two blocks containing the BIOS positions to be restored. 
d) Block holding Core Store contents. 

e) Tape Mark, 

The operator selects the Check Point sequence number to 

be used. The . RST Order restores the previous Core Store 
contents and resets the tapes to their previous positions; 


according to the Check Point sequence number. It then 
restarts the program after the CHKP instruction. 


The program operates in the following sequence: 
a) Search for specified restart point. 
b) Check and re-position files as indicated in File 


Table, The check is made only on standard files that 
‘were open when the Check Point was recorded. 
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RST 

¢) Reload previous Core Store contents from the program initial 
address, (It alsoreloads that part of SRA used by the program 
except for the read and print areas, which are occupied by a 
part of .RST program). 

d) Jump to User routine, if any, to check non-standard files, 
or to execute any other operation before the program is 
resumed, 

e) Reposition:ST (or MT) on program to be resumed. 

f) Resume processing after the CHKP instruction. 

2) Parameter Cards 


The program uses an Order card only, formatted as follows: 


l-4 . RST 
Check Point sequence number (decimal). 


Select number of tape unit on which tape containing Check 
Point is mounted. 


Parity Check Code 


O if even 
P if odd 


Recording density code 


K = 1600 bpi 
800 bpi 
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«RST 

12-17 Serial number of tape containing Check Point. 
18 - 72 Not significant. 

73 - 76 Optional ID Code. 


Blank. 


3) Condition Checking Message 


Message Stops at 
rare TITLE and NOTES 


6101 UNIT X: PERSISTENT ERROR (read) 


6102 UNIT X: OUT OF ORDER 
If after rewind command 
If after read command 
If during final rewind, program ends 
normally, 


6108 PROGRAM TX NOT FOUND 


Program to be resumed not found on MT or ST. 


6110. UNIT X: SERIAL NUMBER Y WRONG/SHOULD BE J 02A6 
Tape mounted on unit indicated in col.9 
has different serial number than that indicated 
incols. 12 -17. 
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RST 


UNIT X: NON STANDARD FILE 
File where Check point recorded is 
non-standard. 


TAPE UNIT CODE WRONG 02A6 
(col. 9) 


ILLEGAL PARITY CHECK CODE O2A6 
(col. 10) 


ILLEGAL DENSITY CODE 02A6 
(col. 11) 


UNIT X: CHKP N NOT FOUND 02A6 
(N = Sequence Number) 


CHKP - BLOCK INCORRECT O2A6 
Block d, page Ill-154, does not cover entire 
Core Store from program initial address to 
Core Store final address. 


UNIT X: POSITIONING ERROR 0246 
(refers to tapes used by program to be 
restarted) 


END OF RESTART/N 
Indicates Check Point Sequence number. 
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. RST 
4) Example 


Problem: To resume a program from CHKP number 0033, 
with following data pertaining to Check Point Tape: 


Unit number: 3 
Parity: odd 
Recording Density: 800 bpi 
Serial number: 0A7913 


Recording mode: 9-track 


Solution: Punch the Order card as follows: 
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«CDC 


e. .CDC Cards Duplicate 


1) 


2) 


Columns 


Purpose and Operation 

This Order is used to duplicate and print out (if requested) 
acard deck. The program also prints out any card 

that has been punched incorrectly, but each of these cards 
is preceded by two asterisks. 

Parameter Cards 


The program uses an Order card and an End card, formatted 
as follows: 


ORDER CARD 


Contents 


«CDC 


¥ = Duplicate and Print. 
D= Duplicate only. 


Not significant. 
Optional ID Code, 
Blank, 
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~CDC 


END CARD 


Contents 


Be 
Not significant 


UNIT X: OUT OF ORDER 


(during final rewind) 
Program ends normally. 


PUNCH ERROR ON CARD 
Incorrect card(s), identified by two 
asterisks, are printed out. 

The program proceeds to its end, then 
stops at address 


PUNCH NOT CONNECTED 


EXECUTION TYPE CODE WRONG 
(col. 5, .CDC card) 


END OF CARDS DUPLICATE 


IIE-160 


Ae 


2. 


3. 
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PART IV - EXAMPLES 


ASSEMBLE AND DEBUG APS PROGRAM 


Problem 


ae 


Assemble the source program. 


be Record a Sample File on tape, for debugging. 

ce Print out Core Store and the Output tape to check the 
program for correct executions 

Solution 

a. The Flow Chart in figure 13 illustrates the ETOS operations 
required. 

be The sequence and formats of the Parameter cards to be used, 
are shown on the Card Formatting Sheet. 

Notes 

ae The .APS, .API, .SGE and .PRL Order cards should have the 
same ID Code so that each of the »API, .SGE, and «PRL 
programs will only be started if the previous program 
was correctly executed. The final check operations must 
be accomplished in any case, so the .MDP and .TDP cards 
must have an ID Code blank. 

b. After the .APS Order card, insert the source program card 
decks 

ce. After the End card of the »PRL Order, insert the file on 
cards, if any. 

d. Use a Pilot 0 card to initialize ET0S, 
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Pitot 0 


ASSEMBLE 
SOURCE PROGRAM 


‘ASSEMBLY 
CORRECT 2 


WWSERT OBJECT. 
PROGRAM l7O ST 


INSERTION, 
CORRECT P 


GEWERATE SAMPLE FILE 


"GENERATION 
CORRECT P 


Yes 
“OAD / START PROGRAM 


PRINT OUTPUT TAPE 


FIGURE 13- APS PROGRAM ASSEMBLY / DEBUG FLOWCHART 
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B. INSERT UPDATED S/R INTO ST 


1. Problem 

Insert a new version of S/R YAAA into the S/R Library of the ST, 

by replacing the old version. The S/R is written in GE-120/130 APS. 
2. Solution 

The Flow Chart in figure 14 illustrates the ETOS operations required. 
3. Notes 

a. .SLS, .APS and .SLI Order cards should have the same ID Code 

so that the insertion of the new S/R is done if the indicated 


operations were correctly executed. 


b. Insert the S/R card deck after the .APS Order card. 


Iv-4 


DELETION 
connecr P 


ASSEMBLE NEW 


YAAA S/R 


ASSEMBLY 
coneacr ? 


INSERT NEW YAAA S/R 
ITO LIBRARY 
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FIGURE 14.- REPLACE SUBROUTINE FLOWCHART 
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A. 


Binary Zero 


Block 


Block 
Sequence 
Number 


Blocks, 
Normalized 


Decimal Form 
Decimal Zero 


End-of-Volume 
{EOV1) 


End-of-File 
(EOF1) 


File Code 
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PART V - APPENDIXES 


GLOSSARY OF TERMS 


DEFINITION 


The octet, character, of field is filled with zero bits. 


An item of information normally treated as an entity by 
hardware (physical record). 

On magnetic tapes, a series of characters that are read 
or recorded during a single data transfer operation. 

Each block is followed by an inter-block (or inter-record) 
gap set to binary zero. 


Decimal number (five digits in length) specifying the 
sequential order of a data block within a tape. Recorded 
in the first five characters of a numbered block. Hf not 
present, the block is called un-numbered. 


Blocks of same length. 


Representation of the digits 0 to 9. 


Representation of a zero in the numeric part (right 
quartet) of a character or octet. When used in one octet, 
the left quartet will contain the hexa. value of 4. 


See "Tape Trailer Label". 


See "File Trailer Label". 


See "File Identification Code". 
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File Creation Date File was generated, recorded in File Header Label. 
Date 

File Header An 80-character block of data identifying the beginning 
Label of a Standard File. Follows the Tape Header Label. 


File Identifica- Alphameric File identifier used within a program. 
tion Code (6 characters long). 


File Name Alphanumeric File identifier recorded in the 12-character 
field of File Header Label 


File Purge Date indicating the day after which the File can be deleted 
Date or updated. Recorded in File Header Label. 


File Retention Length of time during which the File must not be modified 


Period (expressed in number of days). 

File Trailer An 80-character block of data identifying the end of a 

Label (EOF1) Standard Data File, and end of a tape. It contains the 
quantity of blocks in the File. 

File, File containing standard blocks, standard Header (VOL3 

Standard or INT1, and HDR1) and Trailer Labels (EOV1 or EOFi) 
and Tape Marks (TM's) 

Hexa, Abbreviation for hexadecimal, 

Hexadecimal . Conventional notation for designating the 16 possible 


bit configurations of a quartet. Hexadecimal values 
are: 0,1, 2, 38, 4, 5, 6, 7, 8, 9, A, B, C, D, E and 
F. 


. This notation can be used in card punching to introduce 
in Core Store any quartet configuration: one hexa. 
character per column, two hexa. characters per octet. 
This is commonly referred to as "punching in hexadecimal" | 
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- Alternatively, a graphic character can be used (in place 
of a hexa, character) having a right quartet configuration 
in Core Store, equal to the desired configuration. These 
cards are said to be punched in "pure hexadecimal". 

(See GE-100 Graphic Character Set in GE-130 Reference 
Manual, Appendix B. ), 


Tilegal Refers to an item of information which is not accepted 
as a valid representation by the machine design or by a 
specific routine or program. 


Invalid See "Illegal". 

Memory Trace Causes the printout of specified Core Store areas at 

Routine specified points (Trace points) in a program. 

Octet The basic unit of information in the GE-100 Systems, 
composed of eigth binary digits (bits). 

Packed Mode Generally denotes the packing of two decimal digits 

{also "Form") in a single octet. 


Parity bit A check bit that indicates whether the total number of 
"1" bits in a character or octet (including the parity 
bit) is odd or even. If the tctal number of "1" bits 
is always even, the system uses even parity; if odd, it 
uses odd parity. 


Path Trace Causes the printout of all jump instructions that have 
Routine occurred in a program. 

Program Card A punched card containing program instructions. 
Program Code See "Program Identification Code". 


Program 
Identification 
Code 


Program Label 


Program Name 


Program Tape 
Quartet 


Record 


Reel 
Select Number 


S/N 


Tape Header 
Label (Volume 
or Reel) VOL1 
for 9-track tape, 
INT1 for 7-track 
tape) 


Tape Mark (TM) 
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Alphamerie program identifier (four characters in length) 
specified in a Program card, 


Block of data (28 characters in length) preceding the 
program it describes. 


Alphanumeric program identifier (eight characters in 
length) recorded in Program Label. 

See "Tape, Program". 

Half an octet 

Groups of characters normally treated as an entity by 


the program (Logical Record), One or more Records in 
a Block, 


See "Tape". 


See "Tape Unit Select Number". 
Abbreviation for "Serial Number". 


An 80-character block of data indicating the beginning 
of a standard tape. 


A special one-character block recognized by hardware, 
and used as a program separator and at both ends of a 
standard tape. 
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Tape, Program | Standard Tape containing programs (ST, MT or LT). 


Tape Recording | The number of 6- or 8-bit characters that can be 
Density stored in one inch of tape. 


Tape Sequence Sequence number of tape within a File. Four digits 
Number (Volume } long. 
or Reel) 


Tape Serial Alphameric tape identifier recorded in Tape Header 
Number (Volume | Label (VOL1lon INT1). Six characters long. 
or Reel) 


Tape, Standard See "File, Standard". 


Tape Trailer An 80-character block of data indicating the end of 
Label a standard tape. Designated by name, "EOVL". 
(Volume or Reel) | It contains the quantity of blocks in the volume. 
(for Data Files) 


Tape Trailer A 28-character block of data indicating the end of 
Label a standard program tape (ST, LT or MT). The first 
(Volume or Reel) | nine characters are exclamation marks (!) 

(for Program 

Files) 

Tape Unit Controller identifier contained in Tape Unit Name. 


Controller Name | Fixed value, depending on peripheral configuration. 


Tape Unit Name | Used by PER or PERI Instructions to address a tape 
unit, Fixed one-octet value, depending on peripheral 
configuration, 


Tape Unit 
Select Number 


Trace Routine 
Unpacked Mode 
talso "Form" 
Volume 


Work Area 
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Number assigned by the operator to a tape unit. 


See "Path Trace Routine" and "Memory Trace Routine", 
Denotes the use of the right quartet only of an octet 

to store a decimal digit, 

It may also apply to binary numbers. 


See "Tape" 


Core Store area used for temporary storage of one 
Record before and after processing. 
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B. PREREQUISITE AND RELATED READING 


The following material is supplied for the GE-120/130 Systems: 


Catalog Numbers 


APS Programmer's and Operator's Manual 1079 324306107 A 
COBOL Manual 1224 32.30.202 A 
ELOS Operator's Manual 1223 326534505 A 
FORTRAN Manual To be assigned! To be assigned 
GE=-130 Reference Manual 9992 33220,001 A 
GE-120 Reference Manual 1252 32.20.002 A 


Single-Capstan Tape Subsystem Manual To be assigned| To be assigned 
Subroutines, Vol. 1 1225 32,31,104 A 
Subroutines, Vol. 2 1246 32.314105 A 


Codes: P = Prerequisite Reading 


R = Related Reading 
A 


w 


Analysts, Programmers 
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C. SYSTEM RESERVED AREA (SRA) CHART 


CORE STORE ADDRESSES 


From To | From To 
(Decimal) | (Hexadecimal) 
0. (39 


40 45 


Pilot 0 


Day's Date, expressed in the form 
YYYDDD. 

This date ie loaded by the .INT 

Order, 


Check point counter. It is 
increased by 1 by any user 
program each time the 
instruction CHKP is executed, 


MT Control area. Used in starting 
@ program in MIM. 


ID Sequence Validity Switch 
User Special Data area (USDA); 


Loaded by .INT,.PRL, or .NTG 
Orders. 


ID Sequence Code area 


Program Name area 


File Table Address area, 
Set to binary zero if program 
has no File Table. 


Address of first Store location 
after Supervisor (service 
information for ETOS). 
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100 103 


104 


108 


112 


116 


120 


124 


107 


111 


115 


119 


123 


125 


126 


127 


0064 


006s 


006c 


0070 


0074 


0078 


007C 


0067 


006B 


o006F 


0073 


0077 


007B 


007D 


007E 


oo7F 
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System configuration information 


dump instruction to BIOS Tape 
routine for command and 
validation. 


dump instruction to GE-115 BIOS 
Read/Print routine. 


dump instruction to Segment Load 
routine. 


Jump instruction for restarting the 
Tape Read routine after a normal 
call, with no change in Re-entry 
or in the parameters. 

Instruction used for continuous 
tape reading. 


Not significant. 


Address of first location after 
SRA, available to user programs. 
Variable according to system 
confirguration. 


Core Store capacity {in binary), 
expressed in multiples of 256. 


Character H (for Hollerith card 
code). 
Character B (for Bull card code). 


129 


134 
214 


256 


448 


456 


458 


131 


132 
133 
213 
255 


447 


455 


457 


461 


0086 
ooDé6 


0100 


0ico 


o1cs 


O1CA 


0084 
0085 
00D5 
0OFF 


O1BF 


0107 


01C9 


o1cD 
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ST/MT unit Select number. 


WT unit Select numbers. 
1st octet, for WI1 
énd octet, for WT2 
3rd octet, for WT3, if applicable, 
otherwise set to FF. 


Not significant. 
To be assigned. 
Card Read area. 


GE-130 Service and Register area. 


Read/Print routine sub-area. (if 
Hollerith code) 

Area reserved for transcoding 
routine (if Bull code). 


Area containing tape unit names 
(00 to 07). 


HLT instruction indicating 
persistent read or write error. 
This Halt occurs after five 
unsuccessful read/write 
attempts. To make five more 
attempts, press START. 


Jump instruction to the tape 
routine, for making further 
read/write attempts. 


476 479 | O1DC 


489 511 OLEO 


512 513 


01DF 


OlFF 


0201 
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HLT instruction indicating tape 
unit out of order. 


dump instruction to previous HLT. 


HLT instruction indicating block 
number error. 


Jump instruction to the S/R which 
searches forward for the 
correct block, by reading the 
next block, 


HLT instruction indicating tape 
unit out of order, after a 
rewind command, during a Type 
program execution, 

The operator may restart the unit 
by oreasing OPERATE (on tape 
unit ) and START (on CPU 
Console). 


Jump instruction to the S/R which 

attempts the rewind operation 
again, 

In case of persistent out-of-order 
condition, the program stops 
at address 02A6. 


Area reserved for EIOS HLT 
instructions. 


Printer Controller area 


514 


674 


678 


680 


688 


692 


696 


700 


720 


724 


728 


673 


677 


679 


687 


691 


695 


699 


719 


723 


727 


731 
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Print area 


MVI instruction, setting to NO 
(hexa. 01) the ID Switch 
(hexa, address 0033). 


HLT instruction indicating that 
the ID Switch was set to NO. 
Press START, to restart 
Pilot 0. 


PER instructions for resetting 
recording density and parity. 


Re-entry jump area: 
dump instruction either to 
Pilot 0 or to Monitor. 


Monitor Control area 
DELTA fields used by PER 


instructions for setting tape 
density and parity. 


Service area 


Jamp instruction to GE-120/130 
BIOS (for execution). 


Jump instruction to GE-120/130 
BIOS (for validation). 


Jump instruction to GE-120/130 
BIOS, card read routine 
(for execution) 
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———S} 


Jump instruction to GE-120/130 
BIOS card read routine 
(for validation). 


Jump instruction to GE-120/130. 
BIOS print routine 
(for execution). 


Jump instruction to GE-120/130 
BIOS print routine 
{for validation). 


744 751 02E8 O2EF 8 Service area 


752 02F0 See Note BIOS reserved area 


ee —————— 


NOTE: The final address of the BIOS reserved area is depending upon 
the model of Card Reader, Printer, and Tape Units being used. 
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FILE TABLES AND LBC CARDS 
LEC cards are used to update the File Tables associated with the 


Data Files required by the user programs. This Appendix describes 
the LBC cards and the File Tables. 


General Concepts 

Each Data File on tape, before being processed, must be 'opened' by 
the macro-instruction 'OPEN' and 'NEXT', in the APS source program. 
(see APS Manual). 

File opening consists of various checks on the File Label, such as: 

. File Name and Seria] Number 

. File Creation and Purge dates 


- Volume sequence in multi-volume File. 


These checks are performed by ETOS using a File Table and LBC 
ecards, where applicable. 


The File Table contains any relevant File information. LBC cards 
may be used to update the File Table and to specify other checks 

in addition to those which are automatically carried out. 

The File Table is generated by the APS Assembly Program, by using 
the information specified in the instruction 'FILE' in the APS source 
program, and by reserving some areas which are to receive the 
parameters specified on the LBC cards. 


LEC cards are used in three cases: 


Insert the program into the LT (, LTU Order) 
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. Insert the program into the MT (.MTG Order). 
Program load and start up (. PRL Order). 


Refer to the individual Orders for sequencing information. 


2. File Table Format 


A File Table is designed to receive all essential information 
pertaining to the Data Files of a program. 


94 octets are reserved in the File Table for each File, formatted 
as follows: 


Characters 


Type of File: 

hexa. OO, if File consists of Fixed Length records 
(FL File), or 
of Unblocked records (ie. single-record blocks) 
(UN File) 

hexa. 01, if File consists of Variable Length 
records (VL File) 


Binary 94 (length of File Table) 


HDR1 
File Name, read from LBC card, 
File Serial Number, read from LBC card. 


Volume Sequence Number in multi-volumes File. 


0001 (File Sequence Number) 
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Serial Number of first volume in File. | 
File Creation Date, read from LBC card, 


File retention period, read from the RP parameter 
in the 'FILE' instruction of the Source Program, 
If RP parameter is absent, all decimal zeroes. . 

When the program is started, the File Purge date is 
computed and recorded in this field, 


Service character 


File Identification Code, read from the 'FILE' 
instruction, 
After the File set-up phase this field will bo 
used ag the block counter. 


File check options, corresponding to colums 45 
thru 50 in LBC card. This field is initially set to 
YYYYNY by the APS Assembler. 


Select Number of Alternate tape unit (see col, 44 in 
LBC card). 


Reserved for tape routine parameters. 


Code specifying the File format: 

hexa. 00, if Standard File with numbered blocks 
01, if Standard File with unnumbered blocks 
80, if Non-standard File, with numbered blocks 
81, if Non-standard File, with unnumbered blocks 


Work area information. 


Service field. 
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3. LBC Card Format 


Each LBC card contains the parameters referring to a given File. 
The card is formatted as follows: 


Columns Contents 


Y¥LBC (Label Control). 
Name of Program using File. 


File Identification Code (used by the program in the File 
generating and processing instructions). 


19 - 30 File Name, recorded on HDRI1. 


Bl - 36 File Serial Number. 
Blanks if Nin col. 46. 


37 - 42 File Creation Date (/YYDDD). 

Blanks if N in col. 48. 
This date may also be read from the USDA and the Date 
Area in SRA by leaving blanks in cols, 37 - 41 and 
punching a number from 0 to 5 in col. 42, chosen as 


follows: 
Date read from SRA 

col. 42 (Hexadecimal) @ecimal) 

0 0028 - 002D 40 - 45 

1 0034 - 0039 52 - 57 

2 003A - 003F 58 - 63 

3 0040 - 0045 64 - 69 

4 0046 - 0048 70 - 75 

5 004C - 0051 16 - 81 


(See Note 1) 
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Select number of Main tape unit containing the entire 
File or its first volume (see Note 2), 


Select number of Alternate tape unit, if multi-volume 
File is to be read sequentially from both Main and 
Alternate units. 

Select number of Main tape unit (see col. 43) if multi- 
volume File is to be read entirely from that unit. 

Blank if File is single-volume 

> (see Note 2), 


Y, if File Name is to be checked. 
N, otherwise. 


if File Serial Number is to be checked. 
otherwise, 


if volume sequence in multi-volume File is to be 
checked. 
otherwise. 


Y, if File Creation Date is to be checked. 
N, otherwise. 


Y, to disable all operations on the File. 
N, otherwise 
This option applies only to input files. 


Y, if printout of HDR1 label is requested when 'OPEN' 
command ig issued by the user program. If HDRI 
label check fails, a part of the File Table is also 
printed. 

N, if HDR1 label is not to be printed. 
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Columns Contents 
51 File recording density: 
K= 1600 bpi 
L= 800 bpi 
M= 556 bpi 
N= 200 bpi 
52 - 80 Not significant, 


NOTES: 


4, 


1) The date information can be recorded in the Date Area and in 
USDA, of SRA by the .INT, .PRL, or .MTG Orders. 


2) The specification of the Select Number of Main tape unit (col. 43) 
and of Alternate tape unit (col. 44) is optional, because it always 
appears in the FILE instruction in the source program, However, 
when this specification appears on the LBC cards, it overrides 
that in the FELE instructions. 


Processing LBC Cards 


The Orders (. LTU, MTG and . PRL) that process LBC cards, carry out the 


following operations: 

a, Check the Program Name (LBC card, cols. 5 - 12). 

b. Search the File Table (of the File designated in LBC ecard, cols. 13 - 18) 
for the specified information. 

c. Move File Name (LBC, cols. 19 - 30) to File Table. 

d, Move File Serial Number (LBC, cols. 31 - 36) to File Table. 
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Check the date (LBC, cols. 37 - 42), 

Move the date to the File Table. 

If the date is specified in LBC, col. 42, the. LTU and .MTG Orders 
transfer this code to the File Table. The actual date will be read from 
the Date Area or USDA to the File Table, only by the . PRL Order, or 
by the Monitor. 

Compute the File Purge date (. PRL or Monitor only). 


Check the Main tape unit Select number (LBC, col. 43) for validity, This 
number should be 1 to 8. 


Move Main tape unit Select number to File Table. 


Check the Alternate tape unit Select number (LBC, col. 44) for validity. 
This number should be 1 to 8. 


Move Alternate tape unit Select number to File Table. 

Check the options specified in LBC, cols. 45 - 50 for validity, 
Move check options (LBC, cols. 45 - 50) to File Table. 
Check File recording density code (LBC, col. 52). 


Move recording density information to File Table. 


NOTE: The File information that is not affected by the LBC parameters 


is not changed, 
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SYSTEM TAPE GENERATION 


General Concepts 
Every user's system requires a specific (customized) ST for the 


system configuration in which ETOS and user programs are to be 
executed. 


Generation of a customized ST always requires a Sample ST and the 
STG Order. In addition, an STG Loader is required when the Sample 
ST does not conform to the system configuration used for ST 
generation (the Supervisor is not adapted to that configuration). 
The STG Loader is therefore designed to: 


» Adapt the Supervisor to the existing configurations 


+ load and start the STG program, as described in the .STG 
Order. 


STG Loader 
ae Peripheral Unit configuration 
One Card Reader or Card Reader/Punch 
One Printer 
Three Tape units (unit 8 for Sample ST, unit 1 for new 
ST and unit 2 for a WE). 
be Operation 


The STG Loader operates as follows: 


1) Store Segment Load routine and tape routine (which are 
part of the STC Loader). 


y-21 Revs Nove 1969. 


BTOS PROGRAMMER'S MANUAL 


2) Transfer the Read/Print Routines from .STG program (on 
Sample ST) to Core Store, adapting them to the system 
configuration as specified by thea STG Loader Parameter 
card, 


3) The jump instructions to the tape routine and the tape 
error HLT instructions are preset. 


4) Assign select numbers to the tape units. 
5) Label the new Sf and the WT. 

6) Load and start .STG program 

Parameter Cards 


The STG Loader is contained in a card deck, which is read 
inte Core Store together with the following cards: 


1) Program Loader deck, for loading the STG Loader. 


2) STG Loader Parameter card, containing system 
configuration information. 


3) .8TG Order Detail cards, 


The STG Loader deck and the other cards must be introduced 
in the Card Reader in the following sequence: 
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* STE 
PARAMETER CARDS 


ST6 LOADER 
PARAMETER CARD 


ST6 LOADER 
<a | 1 
: 


Upencceed 


The ST Loader Parameter card is formatted as follows: 


Contents 


Colums 


1-4 | 2382 (card name) 


5-6 |06 (fixed) 


7~10 {0200 (fixed) 
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1 = 12 
B14 
15 - 16 
17 = 18 
19 - 20 
21 - 22 
23 ~ 80 


Contents 


Model of Card Reader; 
Bis CRZ1I00, CRZ111, or CRZI20 
¥2= CRP100 


Card Reader Name (in hexadecimal). 
Blank if CRZ100, CRZ111, or GRZ120. 


Model of Printer: 
Y= PRTI0O or PRT110 
¥2= PRT120 or PRT130 
#3= PRTIO5 

¥4= PRII18 


Printer Name (in hexadecimal). 
Blank if PRT100 or PRT110. 


Blank (for Hollerith code). 
Any other character (for Bull code). 


Specify recording density for new ST: 
A2= 1600 bpi 
A= 800 bpi 
MM= 556 bpi 


Not significant 
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e. Condition Checks and HLT Instructions 


0206 


o20¢ 


0212 


Description 


Tape unit persistent error 
(read or write) 


Tape unit out of order 


Invalid Parameter card 
(Error in cols. 11-12, 15-16 or 21-22) 


»STG Program not found on sample ST 


End of Program, after .STG program listing. 
To start .STC program, press START. 
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Fe TAPE UNITS REQUIRED FOR INDIVIDUAL ORDERS 


Group 1. 


Group 2. 


Group 3. 


ae 
be 


WORK 
st, er TAPES 


ST or MP | None WE1SWE2+WT3 (opt) 
8T or MT | None quantity as required 


WI14+WT2 
WE1+HT2+0T3 


None 
Other tape, if source 
program on tape. 
None 


WY14-WT2+0T3 


WM4+WT2 None 
wre None 
None None 


Wi2, if program on | None 
wre 
Wi4W12 if 8/R on 


wi2 


None 


None Two WI's. One WI, if 
duplicating ST or ME 


None 


Wr 


None wr 

None Wr (none if printing 
ST or MT) 

None None 

None None 


WI2, if program on | None 
wre 

WM4WT2 if 8/R on 
wra 
WE140T2 
WI1+WT2 


None 


None 
None 
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None 

wr (none if printout 
only) 

None 

None 

None 

None 

None 

None 

WI for new LT 

WE for current LT, if| 
used, 

WE for LT 


Wr for ME 

Wr 
WE14-WT2 None 
WI1, if printout 
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INDEX OF “TERMS 


Alternate unit 
(also Alternate tape unit) 


APS (Assembly Programming System) 
BASICPRG 

BASICSUB 

BIOS 


CHKP (Check Point) 
COBOL 
Controlled executian 
Detugging Format Node 
DEBUGGING Orders 
- Detail card 


Detail Card Names 
(Used in Order) 
-S6B 
«BPR 
STG 
oDPG 
- DEG - 
-SGE ° 
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EIOS 
End. Card 
File Table 
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IIr 50 
TIE 139 
TIT 150.15 
III 85.18 
III 150.12 
III 85.18 
III 107 
XII 91 
IIL 89 
III 750.14 
Tit 85.18 
III 140 
III 130 
Ilr 139 
IIT 150.13 
III 85.18 
Itt 130 
TIL 88 
III B 
IIT 102 
IIE 112 
TIT 123 
III 103 
III 85.10 
TII 108 
III 30 
III 89 
III 4 
TIT 66 
III 139 

I 4 
IIr 3 
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FORTRAN 
ID Sequence code 
(also Optional ID Code) 
ID Sequence Validity Switch 
(alse ID Switch) 
INITIALIZATION Orders 
LEC card 
LY (Library Tape) 
Main unit 
(also Main tape unit) 
Monitor 
MP (Waster Tape) 
ME Control Area 
MIM (Master Tape Node) 
Optional ID Code 
(also ID Sequence code) 
Order cards 
Order Programs 
Order Program Names 


oAPL Assembled Program Insert 
«APP Assembled Program Punch 
«APS Assemble APS Program 

«EPR Basic Program Replace 

ecDC Cards Duplicate 

CMP Comment 

«COB Compile COBOL Program 
«CRD Card Dump 

»DPG Debugging Program Cenerate 
«FOR Compile FORTRAN Program 
HLT Halt 

eINT Initialize 

«LPD Library Tape Print and Duplicate 
«LIM Library Tape Merge 

«LTU Library Tape Update 

«MDP Memory Dump 

»MIG Master Tape Generate 
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Ir 53 
III 34 
MII 146 
III 159 
III 151 
III 36 
III 82 
III 63 
III 31 
III 152 
III 24 
III 150.1 
III 150.4 
III 126 
Ir 84 
WI 135 
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Term PaRT PAGE 
«MIS Master Tape Stop III 153 
ePCG Punched Card Check III 85.0 
«PRL Program Load IIt 45 
PSC Punched Subroutine Check III 85.4 
«PSI Punohed Subroutine Insert It 85.9 
»RST Restart IIt 154 
eSBP Subroutine Punch III 56.1. 
*SGE Samples Generate TIr vis) 
«SLI Subroutine Library Insert III 115 Dp 
«SLS Subroutine Library Strip TIr 111 
SPC Subroutine Peripheral Change TIt 122 
SPD System Tape Print and Duplicate TIr 94 
»SPG Generate Sort/Merge Program + II 39 
STC System Tape Close TIT oT 
STG System Tape Generate IIr 86 
*STS System Tape Strip III 107 
«STU System Tape Update III 99 oO 
«TCK System Tape Checking TIr 85.15 
TDC Tape Duplicate TIL ST 
«TDP Tape Dump TIr 13 
eTPU ST Program Update IIr 150.8 
»TLW Tape Label Write vr 29 
Parameter cards III “4 
Pilot 0 III 7 
Pilot 1 TIr 10 +] 
Pilot 2 III 12 
PROGRAM TAPE GENERATE AND MAINTAIN Orders IIL 86 
Routing Code III 18 
Segment 00 III 135 
Segment 99 III 136 
Segment Load Routine TII 13 
spc (Sort Program Generator) I 4 
8/R (Subroutine) I 4 
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SRA (System Reserved Area) 
sv (System Tape) 

STG (Loader) 

STM (System Tape Mode) 
Supervisor 

System Tape Generation 
Trace Point 

Trace Point Table 


“TRANSLATE AND GO" Orders 


Translator program 

Type 1 programs 

Type 2 programs 

Type 3 programs 

URA (User's Reserved Area) 
USDA (User's Special Data Area) 
User programs 

Utility programs 

Work Tape (WT) 
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PART ONE. GENERAL DESCRIPTION 
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CHAPTER 1. INTRODUCTION 


1.1. GENERAL 


The Disc Operating System is a comprehensive software system made up 

of programs (pilots, compilers, parametered utility programs) and subrou- 
tines arranged according to certain criteria and usable in keeping with 
well-defined procedures. 


The DOS is used for two specific activities, viz. program generation and 
program running. 


The first of these activities, which consists of compiling, testing and 
debugging programs, takes place during system implementation and again 
whenever new services are programmed or existing services modified. 


As this activity is of a one-time nature, it may be classified as "routine 
operation" 


The second activity, however, consists of normal program running. As 
this activity is of a cyclic or repeated nature, it may be clagsified as a 
"non-routine operation", 


The use of the DOS, whether for non-routine or routine work, achieves the 
following objectives: 


A. Automatie linking between the various phases of an operation which 
reduces operator intervention to a minimum and consequently reduces 
the possibility of error. This means, for example, that it is posstble 
to compile a program, generate sample files, start the compiled 
program and execute file or memory control printouts without involving 
the operator in the transfer from one phase to another. 


DISC OPERATING SYSTEM 


It also means that during a non-routine operation an entire series of 
programs can be executed without interruption, by initially setting the 
linkage between a given program and the one following it. 


B. Standardization of communications between the operator and the 
programs, 
This means that whenever an error or alert occurs in any program, 
standard printouts indicate this status, or the program stops at 
fixed halt locations, which simplify the operator's duties to 2 good 
extent. 


roe) C. Programs independent of the principle peripheral units (magnetic 
tape units, card reader and printer) attached to the system. 
To understand this point, it must be remembered that all programs 
using the DOS use dises (and possibly magnetic tapes), while for 
read and print operations they use routines stored at fixed addresses 
in the memory. Different versions of these routines are used according 
to the system configuration. 

@) Consequently, 2 read or write instruction will always produce the same 

effect, regardless of which peripheral unit is used@). 
In short, this means that a given program can be executed on systems 
using different peripheral units. 


(x) Regarding magnetic tapes, it is, of course, impossible to store data 


necessitating 9-track tape on 2 7-track tape; the contrary is however, 
oO possible. As for discs, only one processing program is available as, up 
oO to the present time, only one type of disc unit is attached to theGE 115; 
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1.2. SYSTEM CONFIGURATION 


The minimum system configuration required for DOS is : 


8192 core positions, except for the orders eCOB and eFOR which 
require 12288 core positions, and for the order eGAF which requires 
16384 core positions. 


- A card reader compatible with the system 
- 2 magnetic dise units - DSU 130 


- A Printer compatible with the system 


1.3. STORAGE REQUIREMENTS 


For systems using a Hollerith reader (Code H), the DOS requires 1600 
core positions; for systems equipped with a BULL reader (Cade T), the 
requirement is 1800 core positions. 


This area will contain Input/Output management programs, i.e. a read 
routine, a write routine and a disc management routine. It will also 
contain read and write areas, segment load routine, a trascoding table 
for systems using a BULL reader (Code T). The contents of this area is 
described in section 4.3. 
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CHAPTER 2. DOS FUNCTIONS 


2.1. 


PROGRAM COMPILATION 


A primary problem solved by the use of the DOS is the compilation of 
program written in symbolic language, 


The programmer will never write programs directly in machine language, 
but will use general languages such as TAB III and APSII or specialized . 
languages such as SPG (Sort Program Generator). 


Using the DOS, any program writtent in one of the specificied symbolic 
languages can be compiled. 


A program written in APS requires a single pass to compile it in machine 
language. For a program writtent in TAB or SPG, two passes are required 
to compile the object program in machine tanguage. 


The TAB and SPG compilers generate an object program in APS language, 
which must, in turn, be translated into machine language by the APS 
eompiler. 


Passes from one phase to another are accomplished without operator 
intervention. 


The DOS includes 2 comprehensive subroutine library. Using symbolic 
programs, subroutines are called implicitly in certain macro statements 
or explicitly through the SUB statement. 


In answer to such calls, the compilers assemble the subroutine for the main 
program. 
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An object program can be made up of one or more segments, 


The object program for a source program written in TAB or SPG language 
will always be made up of more than one segment. 


The object program is produced by the APS compiler in a work area of the 


volume containing the program file (System Disc). Another operation 
inserts it in the program file so that it can be initiated. 


PROGRAM TESTING AND DEBUGGING 


DOS contains a comprehensive set of tools that give considerable aid during 
program testing and debugging. 


Through the use of these tools, before actual program initiation the 
programmer can create sample disc or tape files. He can also request 
that his program be "traced", i.e. that all jump instructions executed be 
printed. 


A compiled program can be regenerated in controlled form, i.e. so that it 
will accept correction cards in machine language and print the contents of 
the major memory areas at previously specified locations. 


In addition, it is also possible to interrupt processing at any point during 


the test phase of a program for check-out purposes, such as file print-out 
and memory check. 


PROGRAM STORAGE 


After testing and debugging, a program should be re-writtent in symbolic 
language in its final form and then re-compiled. 
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‘The resulting program shoud be inserted in the appropriate file containing 
all the other programs that have been tested and debugged. This file 
(Library Dise) serves as a "collective file" for the EDP center. The contents 
of the LD are maintained by DOS. 


PROGRAM EXECUTION 


DOS is also a considerable help in normal management. In preparing a 
program for execution or in scheduling work for the day, the user must 
indicate which programs are to be executed. He establishes the order in 
which programs are to be run by setting the criteria which specify the 
linkages between programs and the point(s) for operator intervention, 
when required. 


DOS combines these programs and makes up a special file, known as the 
Master Disc, which links each program with the next one by means ofa 
Monitor which starts up the next program in accordance with the initial 
choice. 


Livkage from one program to another occurs automatically without operator 
intervention. The operator intervenes only where specified by the user, e.g. 
to mount specific tapes or dises or to change the paper in the printer. 


Once the Master Disc has started operating, it executes all the programs 

in the order specified by the user. In this way, once the user has established 
execution criteria for a given job and set up the Master Disc for this job, 

the program execution sequence can no longer be changed. 


Each program can, however, be initiated individually by using the Library 
Disc. 


DISC OPERATING SYSTEM 


CHAPTER 3, SYSTEM DESCRIPTION 


3.1, FUNCTION OF THE PROGRAM FILES 


In the previous section, reference was made to the function of the program 
file of the System Disc, Library Disc and Master Disc. 


The file containing the programs is organized similarly to a data file. 

This file is identified by a file label, written on the first track of cylinder 
zero, which contains the name, date of creation and size within the volume. 
The file may occupy any volume area, but cannot be split up. The area 


occupied by the program file must consist of an integer number of 
cylinders. 


At the beginning of each file there is an index of the programs (and subrou- 
tines, if any) contained in the file, 


The program file is always one volume and is -written in the sector mode. 
A volume cannot contain more than one program file. As a result, the 
System Disc, Library Disc, and Master Disc will always be stored on 
different volumes. 


The same volume occupied by a program file can also be occupied by data 
files since the program file appears the same as any other file on the 
volume, The names System Disc, Library Disc and Master Disc are 
deceptive in that they give the impression that the entire disc is at the 
program's disposal. Although it is true, that a program file must always 
be accessible, both for routine and non-routine operations, this does not 
mean that the dise unit is completely available for programs. 
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3.1.1. The System Dise (SD) 


The System Disc is the basic program file for DOS. It contains the 
complete software system and is used to derive the Master Dise or 
the Library Dise either directly or indirectly. 


The System Disc contains the following: 

a. Basic programs (i.e. system pilots, input/output management 
programs) 

b. Subroutine library 

ce. Compilers 

d 


Parametered utility programs 


e. Auxiliary and debugging programs 
f. System initialization programs 

g. System management programs 

h. User's programs, if any. 


Some of the more commonly used programs such as the Basic Program 
are functionally a part of the System Disc, but are written outside the 
program file's physical limits, viz. on tracks 1 through 9 of cylinder 
zero. Since the contents of cylinder zero is recorded on all the volumes 
during serializing, the fundamental programs of the DOS can automati- 
cally be used by the Library Dise and the Master Disc as well. 


The System Disc is used for compiling, testing and debugging the 
user's programs, 


The user programs are normally found on the System Disc only during 
the test phase, After the program has been completely checked and 
debugged, it is inserted on the Library Dise ready for future use. 


A user program can, however, remain on the System Disc even though 
it is in its final form, 
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3.1.2, The Library Dise (LD) 


3.1. 


The Library Disc is the file that contains the user programs that have 
already been debugged. It is always stored in a volume other than the 
volume in which the System Disc file is stored. 


The contents of cylinder zero is identical in both volume, and the 
fundamental DOS program, such as the Basic Program, also form 
part of the Library Disc. 


The Library Disc also contains all the programs that are required 

to set up the Master Disc and make it operational, which means that it 
also contains the specific Master Disc generation program and 
initialization program, 

The Library Disc contains the following: 

- Basic Program 

- Fundamental DOS program required to set up the Master Dise 

- All the user's programs in their finat form. 

Since the Library Disc contains the Basic Program, it can control the 
start and execution of the user's programs, It is not, however, possible 
for the Library Disc to achieve automatic linking to the execution of a 
series of programs; the Master Disc can do so. 

3. The Master Dise (MD) 

The Master Disc is a file containing all the programs linked together 
that constitute the routine job flow for a given period of time in the 
system: e.g, a day's work. 

The programs forming part of the MD are taken either from the SD or 


the LD. 
Two segments are added to each user program at the moment it is 
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inserted in the MD: one beginning segment containing the program 
start conditions; an end segment which starts the Monitor and 
determines its running conditions, i.e. the standards according to 
which it selects the next program to be started. 


The Master Disc always contains the following programs: 
1. Basic program 
2. System initialization programs 


3. All the user programs that must be executed in that particular 
phase of the work. 


In addition to the above programs, which form the essential contents 
of the Master Disc (MD), the user can insert the DOS programs he 
thinks necessary, e.g. the restart program (if restarts have been 
allowed for in the user programs), the file label writing program 
the dise print program, etc. 


The flexibility of the system allows a Library Disc (LD) to be genera- 
ted, or else a Master Disc (MD), with programs being transferred from 
one file to another, as shown below: 


ik 
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With three disc units available, the following procedure may be 
applied : 


ORDERS 
To use the DOS, the user must indicate an appropriate sequence or order 
which is communicated to the system via a punched card known as an order 
card, For example, to compile a TAB program, a card containing the 
following indications in the first columns must be transmitted to the system: 

eTAB 

The DOS does not come to a halt after executing an order, but looks for 
another order card. It is therefore capable of executing a series of orders 
without coming to a halt. 


The user must thus plan his work by preparing a deck of order cards. 


For example, assuming that a program to be coded in APS is to be compiled 
and then test run,the following order cards must be communicated to DOS: 


a. Program compilation 
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b. Insertion of the object program on the System Dise to allow execution 
c. Generation of sample files, where required 

d. Program execution, 

Each of these orders is transmitted by one card. 


Order cards are all marked with the character .(period) in the first column, 
followed by an alphabetic code of 3 characters which specifies the particular 
type of order. 


In this case the orders would be coded as follows: 


eAPS - compiles an APS program 

eAPI ~ inserts the compiled program on the SD 

eDIL - writes the sample file on the disc 

ePRL - starts the compiled program, 

The information contained in the order card is not always sufficient for the 


DOS to carry out an order so that order requirements must be further 
Specified in other cards. 


In this way, the eDIL order must be followed by the cards containing the 
information to be stored; the eAPS, and other compilation orders eTAB 
and eSPG, must be followed by the source program cards. 


In this ease, it may be said that order cards have to be followed by "detail 
eards" specifying the order requirements. 


Still referring to the previous example, we note that the contents of the 
order eAPI is wholly specified in the order card itself and is not followed 
by any detail cards, while the order ePRL is followed by LBC opening 
cards only when it is desired to modify the program file table. 
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In short, three cases are possible: 


a) The order card is never followed by detail cards 

b) The order card is always followed by detail cards 

ec) The order card may be followed by detail cards. 

In cases b and c, the end of the detail cards relative to a given order must 


be indicated by an order "End Card" to keep the next order card from being 
taken as a detail card and as such not being recognized. 


In case c, when there are no detail cards, the order "End Card" must be 
present just the same, after the order card. 


Referring again to the series of orders in the previous example: 


eAPS - compiles an APS program 

eAPI - inserts the compiled program in the SD 

eDIL - writes a sample file on disc 

ePRL - starts the compiled program. 

It is obvious that the order eAPI cannot be extended if the previous order 


has not been completed. In the same way, order e PRL cannot be executed 
if the orders eAPI and eDIL have not been executed correctly. 


To achieve this linkage of orders, a specific order card code must be used: 
the "serial code". This code is used to identify a complete series of dependent 
orders, as explained above. 

When there are consecutive orders marked by the same serial code, the 

DOS executes an order only if the previous order has been executed 


correctly. 


Tf an order has no serial code, it is still executed. The presence of an 


14 


DISC OPERATING SYSTEM 


order without serial code among other orders all having the same serial 
code does not interrupt the series itself. 


To return to our example again, 


We have four dependent orders, all of which are identified by the same 
serial code: 

eAPS - serial code AAAL 

eAPI - serial code AAA1 

eDIL - serial code AAAI 

ePRL - serial code AAAL 


These orders are connected to one another in such a way that failure to 
carry out one of them prevents the execution of those following. 


Suppose we now wish to insert the Disc Print order (eDIP) after the order 
eDIL, in order to print the sample file. 


We want this order executed even though the previous order was not 
completed. The order eDIP will have no serial code, The orders will then 
be arranged as follows: 

APS ~ serial code AAAI 

eAPI ~ serial code AAAI 

eDIL - serial code AAAIL 

eDIP - serial code KYKE 

ePRL - serial code AAAL 

The order eDIP is always executed, while the execution of the order ePRL 


remains conditioned by the correct execution of the order preceding the 
eDIP. 
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The series of orders is interrupted only when there appears an order with 
a different serial code. 


Example: 


eAPS ~ serial code AAAI 
API - serial code AAAI 
eDIL - serial code AAAI 
eDIP - serial code Usb 
ePRL - serial code AAAL 
eAPS - serial code BBBB 
eAPI - serial code BBBB 


The second order eAPS is no longer connected to the preceding orders, but 
starts a new series. 


Columns 73 to 76 are reserved for the serial code. Columns 77 to 80 must 
remain blank. 


Columns 5 to 72 may be used to specify the order further. 


The general layout of the order cards is therefore as follows: 


Col. 1 - @ (period) 

Col. 2to 4 - order identification code 
Col. 5 to 72 - other information (if any) 
Col. 73 to 76 - serial code (if desired) 
Col. 77 to 80 - bee 
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EXECUTION OF ORDERS BY SYSTEM DISC (OR LIBRARY DISC) 
In the previous paragraph we saw how a series of orders is formulated. 


We will now turn to the procedure used in executing the orders. 


The SD, the basic program file of the DOS, can execute all possible orders. 
It is used to carry out what we have loosely termed routine operations, i.e. 
compilations, debugging of user's programs, building up and maintaining 
the Library Disc. 


The SD therefore contains all the DOS programs. For each order (with the 
exception of eCMT, eHLT, and eMDP)there is a corresponding program on 
the SD. 


Besides all these programs, the SD contains the Basic Program, which is 
the fundamental program for the whole system. In addition to fulfilling the 
functions of pilot program through reading and interpreting order cards and 
initiating the corresponding program to be executed, this program algo 
contains the input/output control routines, i.e. those routines responsible 
for actual tape and dise management operations and the read and print 
routine. 


The initialization of the system takes place with the start of the Basic 
Program. Its first operation is to read a card and check if it is an order 
card, 

If not, it reads another card until it finds one that is recognizable as the 
order card, that is, marked with a character e in the first column. Then 
it prints the card. If the order is of the types eCMT, eHLT, or eMDP, it 
executes it directly; otherwise it retrieves the program from SD and 
starts it. At this point, the control of the system is transferred to the 
program, which reads and processes the detail cards, if the order 
requires it. 
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When it has been executed, each DOS program restarts the Basic Program, 
to which control of the system then returns. The program for the order ePRL 
is an exception to this, its duty is to start a user program. In this case, 

the user program will restart the Basic Program. 


Let us now consider the case of orders connected to one another by means 
of a serial code, When the Basic Program reads an order card with a serial 
code for the first time, it saves the code in a service area that will be 
updated only when a card with different code is read. Every time the 

Basic Program encounters an order with a serial code, it compares this 
code with the one in the service area. If the two codes are equal , a specific 
condition will be tested to determine whether the order is feasible or not. 
This condition is called the "feasibility condition" and can assume two 
alternate values : 


YES - the order is feasible (i.e. can be executed) 


NO - the order is not feasible because a previous order of the same 
series has not been correctly executed. 


The initial value of the feasibility condition is YES. It is set to NO by DOS 
programs when they encounter incidents or errors that block the execution or 
invalidate the results. Before restarting the Basic Program, the user 
programs can also force the feasibility condition to NO. The Basie Program, 
then, when ecountering an order with serial code equal to that of a previous 
order, tests the feasibility condition. If this is YES, it starts the order's 
program, if it is NO it goes on to seek another order card. When it reads 

a card with a serial code different from the one stored in the service area, 

it updates the service area and resets the feasibility condition to the values 
YES x. 


% As will be explained later, in order to guarantee that the MD works 


correctly, the Basic Program sets (Basic) the feasibility condition to 
YES even when it starts the order ePRL. 
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A schematic diagram of SD operation ig given in Figure 1. 


What has been said for the SD is also valid for the LD, with this 
difference: in the LD, not all the DOS programs are present, but only 
those that allow the set up of the MD. However, all the DOS programs 
present on the LD can be started by the order cards and are processed 
by the LD in exactly the same way as the SD, 


3,4. HOW THE MASTER DISC WORKS 


Pa) 


The Master Dise is 2 program file specifically generated for a given 
type of work, for example, an entire service of an application system, or 
a day's work. 

Contained on the Master Disc are all the user programs involved in the 
work to be executed and the more generally applied DOS programs. 


*) The MD initialization takes place with the Basic Program start. The Basic 
Program reads and interprets the cards and starts execution of the orders. 
The MD, therefore, works in the same way as the SD until a user program 
is started through the order ePRL, At this point, the user's program runs 
until its funetion is completed, then the Basic Program transfers control 
to the Monitor. As a result of the options executed, when the program was 
inserted in the MD, the Monitor carries out one of the following functions: 


(*) 1. Seeks and starts a program selected by the operator. 


°o 


2, Seeks and starts one of two possible programs selected by the operator 
positioning Switch 2. 


3. Reads an order card and starts executing the order's program or if 
the order is ePRL, starts the program indicated. 


4. Halts due to end of processing. 
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5. Seeks and starts a program selected by the previous program, which 
stored the program name in the card read area, 


In the third case, if the order is ePRL, the Monitor directly starts the 
program requested, otherwise control of the system returns to the Basic 
Program and remains there until a new ePRL order card has been read, 

In cases 1, 2 and5, before starting the next program the Monitor examines 
the feasibility condition. If this is NO, instead of starting the program 
requested, it restarts the Basic Program. 


The feasibility condition may be set to NO by any user program. & 
Tn this case, none of the programs linked to it are executed. The feasibility 

condition is setto YES by the Basic Program each time the order ePRL 

is executed. 
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eS. 


set first 
time switch 
to no 


save 
serial code 
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condition 
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Figure 1 20.1 


CHAPTER 4, 


4.1. 


DISC OPERATING SYSTEM 


SYSTEM COMPONENTS 


PROGRAM FILE STRUCTURE 


Within DOS the program files on the LD, MD, and SD have 2 common 
structure with differences retative only to type of programs and number 
of programs present on each of them. In the following description of the 
program file, these differences existing between the three discs are 


pointed out. 


4.1.1. Program File Label 


The Program Fite is identified by a label in the file table, written in 
6 bit mode in one of the sectors from 2 to 17 of cylinder zero, and 
having the following structure: 


CHARACTER (S) 


1-4 
§- 21 
22 - 41 
42-47 
48 - 53 
54 


DESCRIPTION 
HDR1 


File identification the first two characters 
must be LD, MD, or SD (for Library Disc, 
Master Disc, or System Disc respectively), 


Not used 

BYYDDD - creation date 

Not used 

P (= Program file) file type code 
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CHARACTER(S) DESCRIPTION 
55 - 57 nnn ~ first cylinder address* reserved for 
the file 
58 - 60 unn - last cylinder address reserved for the 
file 
61 - 65 Address of the first free sector in the file 
area 
66 - 70 Address of the last page of the subroutine 
library. If this page is missing, address of Q 


the first sector after the longest sector set 
aside for a subroutine index, if one exists 
(the indication f is only applicable to the 
SD) 


7 - 100 Not used, 
4.1.2. Program File Index oO 


The first part of the dise area reserved for the program file is occu- 

pied by the program file index. This index is written in 6 bit mode, 

three sectors in 2 page. 

Two tracks are reserved for the index on the LD and SD and a single 

track onthe MD. 

The end of the index is indicated by the character E. As 15 characters 

are allowed per program, the LD and SD can contain a maximum of oO 
259 programs and the MD a maximum of 119. The index has the (+) 
following structure: 


% The cylinder address is the address of the first sector of the cylinder. In 
this case, only the first three characters are expressed, as the tast two 
characters are always zero, 
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CHARACTER(S) DESCRIPTION 
2 Program type code; this code can have one 
of the following two values: 
1 - DOS program 
3 - user program 
2-9 Program name, in alphanumeric characters 
10 Program code: 


Code C if the program is generated in 
controlled form (see order eDPG). If 
the program is in normal form, this 
code indicates the use of basic programs 
on tape and on disc. 


B= program use tape management routi- 
nes only. 


1 = program uses disc management 
routines only 


2 ~ program uses both routines 


3 = program uses neither of the both 
routine. 


11-15 Dise address of the first page of program, 
which contains the program label. 


Programs appear in the index in the same order in which they were 
written on the file. 


4.1.3. Program Structure 
On the LD and MD, programs immediately follow the program file 


index, while on the SD, they follow the subroutine library. Program 
are written in 8 bits mode in pages of variable length. 
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Each page of a program is preceded by a page label containing 
pertinent information about the following page. The first of these page 
labels also contains information pertinent to the entire program and is, 
therefore, called the program label. 


The address of program label is contained in the file index with the 


program name. 


Each page label occupies a sector and has the following format: 


CHARACTER(S) 
i 
2-3 
4-5 
6-7 
8-12 
18-75 


DESCRIP TION 


Segment indicator in binary: 


00 not last page of segme nt, 
FF last page of segment 


Segment number in decimal 

Length of page minus 1 in binary 

Memory address of page in binary 

Sector number of label for next page 
00000 No more pages. 

Not used by page label 


The program label also contains the following information: 


CHARACTER(S) 
51 - 52 
53 - 54 
55 - 56 
57 - 62 


DESCRIPTION 
Address of the beginning of the file definition 
table in binary 
Program start address in binary 


Last memory address + 1 of program in 
binary 


¥YYDDD ~ Insertion date 
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4.1.4, The Subroutine Library 


The subroutine library is only found on the SD and immediately follows 
the Program File index. It is written in 6 bit mode and preceded by an 
index, There are ten sectors in a page. Each record has the following 


structure: 
CHARACTERS DESCRIPTION 
1 x 
2-6 Sector number of first page of subroutine 
7-12 Subroutines name 
13-16 Subroutine length in unpacked binary 


A maximum of 6 subroutines can be indicated. Information regarding 
these possible subroutines is given below. They must be in the 
following format: 


- 6 characters for the subroutine name 
- 4 characters for the subroutine length. 


Index records therefore vary in length from 16 to 64 characters. The 
end of meaningful information on a page is marked by an asterisk, and 
the end of the complete index by two asterisk. Five tracks are set 
aside for the index. 


Subroutines immediately follow the subroutine index and cover a whole 
number of variable length pages with a maximum length of 12 sectors, 
The first characters of each page contain the following information: 


CHARACTERS DESCRIPTION 
1-5 Dise address of the next page 
6-11 Subroutine name 
12 Number of subroutines required by this 


subroutine (from 0 to 6) 


13 - 18 BYYDDD - subroutine insertion date, 
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Next follows a list of any subroutines called, The list is in the 
following format: 


~ 6 characters for the subroutine name 
- character for the sequence number 


After this list for which 42 characters are always reserved, comes 
the following information: 


-  4characters ~ Length of the part of the subroutine inserted in 
the page 
~ 4 characters ~ Memory address of this page. 


Then follows the actual text of the subroutine. Each subroutine has been 
translated into basic language and compiled relative to a starting 
address of zero. The result is that these addresses are all relative and 
must be adjusted, when assembling the subroutine to the main program, 
by adding to them the actual memory address. 


Subroutines are written in 6 bit mode and are therefore unpacked. The 
comment area assumes one of the following values to accomplish this 
adjustment: 

4 ~ no adjustment 
b. 5 - adjustment required during assembly phase 


ce, A -two characters preceding call subroutine sequence number. 
This value is written with the no adjustment value 4. 


d. B ~ peripheral unit number which varies according to the system 
configuration. 


The end of meaningful information on a page is marked by the character 
R and the end of the complete subroutine by the character E. 


The subroutine library occupies a whole number of tracks. The sector 


number of the last subroutine track is contained in the program file 
label. 
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4,2, 


Contents 


Program File Index 
Subroutine File Index 
Subroutine Library 


Programs 


Program File Index 


Programs 


Program File Index 
Programs 


INITIALIZATION PROGRAMS 
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The following table summarizes the make up of program files, 


6 bit 
6 bit 


Pilot Zero is a one card hexadecimal program which initializes the 


This program varies according to the actual unit on which the program 
to be initialized is mounted (from then on this file will be called the 
system's basic program file). It is started manually by pressing the 
RESET, LOAD 2 and RUN buttons, in that order. It reads the Bootstrap 
in sector 00020 of the disc which contains the program file and starts 
the operation. 


Pilot Zero is permanently stored in the memory where it occupies the 
first 40 positions. 
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4.2.2. Bootstrap 
The Bootstrap program is the link between the Pilot Zero and the 
Basic Program. Along with the Basic Program, the Bootstrap is 
stored on cylinder 0 of each volume and takes up dise sector 0020. 


The Bootstrap reads the following sector containing the list of 
programs present on eylinder 0, then starts up the basic program. 


The Bootstrap is, then, overlapped. 

4.2.3. Basic Program 
The Basie Program consists of the following segments: 
1st segment : Pilot One 


This is the first of the two Basic Program Pilots, It is started by the 
Bootstrap. 


Pilot One reads all order cards, checks their validity and checks 
feasibility condition, directly executes the orders eCMT and sHLT, 
starts the memory dump routine for an order eMDP and the programs 
associated with the orders eDNA and eLPC (which are also stored on 
eylinder 0), and loads Pilot 2 in all other cases, 


After execution, Pilot 1 is overlapped. 

2nd segment : Data and Service Area 

The data and service area segment contains all the data relevant to the 
particular system configuration, the DOS service area, the card read 
and print areas and the transcoding program for systems equipped with 


a BULL card reader. 


This segment is loaded by Pilot 1 and always remains in memory from 
decimal addresses 100 to 511. 
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3rd Segment : Read and Print Routine 


This routine is used by the DOS for card read and printing operations. 
This routine varies with the particular type of card reader and printer 
attached to the system. 


The read and print routine is used by all DOS programs and is called 
by user programs through macro-instruction «LBSS, (see the manual 
"APS II Basic Language"), 


The read and print routine always remains in memory during the 
execution of DOS programs and user programs. 


4th Segment : Memory Dump Routine 

This routine is started by Pilot 1 when an order eMDP is read. 

5th Segment : Magnetic Tape Routine 

The tape routine executes all the physical operations related to 

magnetic tape processing: read, write, rewind. Logical file proces- 

sing subroutines, i.e. subroutines for macro-instructions GET, PUT, 
OPEN, etc. , use this routine. (See the manual "APS I Basic Language"). 
The tape routine is loaded into memory above the read and write 

routine and may be overlayed by programs which do not process magnetic 
tape files. 


6th Segment : Segment Load Routine and Disc Routine 


The segment load routine is used by DOS as well as user programs to 
seek and start a program segment. 


The disc routine carries out all the physical operations related to the 
handling of magnetic disc units: read, write, position, or control. The 
logical file processing subroutines and DOS programs use this routine. 


This segment always remains in memory. 
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7th Segment : Pilot 2 


Pilot two is loaded and started by Pilot One for certain orders after 
they have been checked for feasibility condition, It seeks and starts 
the associated program to be executed, 
In addition to the Bootstrap and the Basic Program, cylinder 0 contains 
the programs associated with orders eDNA (which assigns logical numbers 
to dise units) and «LPC (which loads programs from cards). 
Although these programs are not part of the Basic Program, they are 
located in the memory between the 5th and 6th segments, 
RESERVED AREA 

DOS system requires a reserved area of 1800 characters, for a system 


configuration using a BULL reader. 


The size of this area is increased by 500 characters for mixed magnetic 
tape-dise programs. 


The contents of this area is specified in the following table: 


ADDRESSES 


LL CONTENT 


BEGIN END 
0027 40 | Pilot Zero. : zl 
002D 6 | Day's date, placed by the order eINT. 
0031 4 |Decimal counter of the restart points, It 


is incremented by 1 by all the user 
programs when they execute a macro- 
statement CHKP or DCKP. 
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CONTENT 


Control area, The first position is used by 
Pilot 1 of the Master Disc to check if the 
order card has already been read by the 
Monitor, 

The second posizion is used for controlling! 
the feasibility condition. 


0034 0053 82 Area reserved for the user loaded by 
the orders efN'T and ePRL or from the 


segment 00 of a type 3 program, 


0054 0057 4 Storage area for serial code. 

0058 oosYr 8 Name of program being executed, 

0060 0061 2 File table address. 

0062 0063 2 First address left free by the Basic 
Program. 

0064 0066 3 Free positions. 

0067 0067 1 Hexadecimal number of punch, if provision 


made for it in the system configuration. 


0068 006B 4 Jump Instruction for starting the mag. tape 
subroutine. 
006C o06F 4 Jump Instruction for starting the read and 


print subroutine. 


0070 0073 4 Jump instruction for starting the segment 
load routine. 
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ADDRESSES 
LL CONTENT 
END 
0077 4 Jump instruction for restarting tape routi- 

ne after normal call with no indication of 
re-entry or parameters. This instruction 
can be used for continuous reading. 

0078 007B 4 Jump instruction for starting disc routine. 

007C 007D| 2 Address of first memory position that can 
be used by the programs, i.e. 1600 for 
systems using a Hollerith reader, 1800 
for systems using a BULL reader. This 
address does not include any tape routine. 

O07E 007E 1 Store dimension in multiplesof 256. This 
data is exepressed in binary form. 

oo7F 007F| 1 The letter H, for System using a Hollerith 
reader, the letter B, for Systems using a 
BULE reader. 

0080 0080 1 Logical number of the dise unit containing 
the initialized program file. 

0081 0083 3 Free positions. 

0084 0084 1 Number of tape units connected to system. 

0085 0085 1 Free positions. 

0086 00D5 80 Card read area. 

0oD6 oOFE! 38 Area at diposal of subroutines. 

00FC OOF F 4 Re-entry jump after jump and return 
(instruction JRT.) 
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CONTENT 


Area reserved for read and print routine, 
for a system using a Hollerith reader, and 
for the transcoding table for a system using 
a BULL reader. 


Correspondence table between the logical 
and physical numbers of the dise units, 


Extension of 0100 to 016D, 


Transcode routine for systems using a BULL 
reader. For systems using Hollerith readers, 
the transcode routine is substituted by a 
re-entry jump. 


Extension of 0100 to 016D, 


Correspondence table between logical and 
physical numbers of the tape unit. 


Tape routine HLT instruction, signalling 
persistent reading or writing, error after 
five efforts; followed by a jump instruction 
to restart attempts. 


HLT blocking instruction belonging to tape 
routines signalling unit out of services, 
followed by a jump instruction that ends back 
to the same HLT, 


Tape routine HLT instruction, signals error 
in block number after five attempts to find 
the exact block. It is followed by a jump 
instruction to restart attempts. © 
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CONTENT 


20 


160 


HLT instruction signalling disc unit out of 
service. After the first attempt, DOS programs 
are skipped, It is followed by a re-entry to the 
program, 


Disc routine HLT instruction signalling persi- 
stent error, after five attempts. It is followed 
by a jump instruction to restart attempts, 


Dise routine instruction HLT signalling unit 
out of service. It is followed by a jump 
instruction restarting the routine for a new 
attempt. 


Area reserved for HLT instructions of the file 
logical handling subroutines (see "The APS 7 
Language"). 


Area at disposal of printer controller. 
Print-out area. 


Instruction setting the feasibility condition to 
NO. The DOS and user's programs jumpt to this 
address in the case of error. 


HLT instruction signalling the previous 
operation. 


Jump instruction restarting Pilot Zero. If the 
system control is the MD, at this address there 
is a jump to the segment load routine, followed 
by the parameters for starting the segment 
(segment number and starting address). 
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02B5 


02BA 
02BC 


0200 


0202 
02C6 


02D0 


ADDRESSES 


02B9 


02BB 
02BF 


02C1 


02C5 
02CF 


0833, 
(08FB) 


DISC OPERATING SYSTEM 


CONTENT 


Starting address of the check point file. 


Program label address of the program 
being executed, 


Number of segment in execution. 


Instruction setting the feasibility condition 
to NO, It is used by the segment load 
routine if the segment cannot be found. 


HLT instruction signalling previous 
operation. 


Jump instruction re-starting Pilot Zero, 


Instruction setting the feasibility condition 

to NO. It is used by the segment feed routine 
in cases of persistent error in dise operations, 
Like the previous one, it is followed by a 

HLT and a re-entry jump to Pilot Zero. 


Segment feed routine, dise routine, tape read 
and print routine. 


N.B. : (x) Starred data apply to systems using a BULL reader. 
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5.1. CONDITIONS FOR INITIALIZATION 


Initialization of DOS depends on two preliminary conditions: preparation 
of a deck of order cards and detail cards for the work to be carried out, 
and preparation of the program file which will execute the work. 


The type of program file to be prepared depends on the nature of the work 
to be carried out : for compilations, tests and debugging, the SD is used; 
for routine work, the MD is used. 


Certain types of processing require two program files, as when a 
program is transferred from the SD to the LD using the order eLDU but 
in any case a single file is initialized and serves to control the entire 
processing operation: this file is called the basic system file and the 
volume on which it is written is called the basic disc. 


If an SD or LD file is initialized, work sequence is entirely dependent m 
order cards. If the MD is initialized, however, processing is carried out 
through appropriate inter-program linkage. In this case, as well, 
processing will still be controlled by an order card. 


Before any processing can take place, the orders eDNA and eI[NT must be 
executed. 


Pilot Zero is located at the head of the card order deck. It reads on the 
unit housing the file to be initialized. 
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5.2.1. Functions of Pilot 0 


Pilot Zero is loaded into memory and started by means of the manual 
initialization operations (RESET, LOAD 2, and RUN). Pilot Zero reads 
the Bootstrap from sector 00020 of cylinder zero, The Bootstrap will 
then start Pilot One of the Basie Program. 


restarted each time a new order is to be executed. While 2 program is 
running, the processing can be interrupted and the next order can be 
started by pushing the buttons RESET and RUN, unless the first forty 
memory locations have been altered. 


Aa) Pilot Zero is always present in memory's first forty locations and is 


5.2.2. Functions of Bootstrap 


oO The Bootstrap reads the directory of programs written on cylinder 
zero, retrieves the first segment of the Basic Program (Pilot One) 
and starts it. 
A persistent read error halts at location 012C. Pilot Zero is restarted 
by pressing the RUN button. 


5.2.3. Functions of Pilot 1 
i) Pilot One carries out the following operations: 


a) Introduces tothememory the second and third segments of the 
Basic Program (data and service area and read print routine). 


b) If the MD file is initialized, checks that the order card has not 
yet been read by the program Monitor (value 01 at memory 
position 0032), otherwise it moves right on to the next operation, 


e) Reads cards into the read area until an order card ean be 


identified (character @ in the first column) and prints the card 
preceding it with three asterisks and the day's date. 
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e) 


5.2.4, 


DISC OPERATING SYSTEM 


Checks the order feasibility condition via memory position 0033. 
This position may contain two different values: 


00 = Feasible 
01 = Not feasible 


If the order cannot be executed, it prints the following message: 


5010* ORDER NOT EXECUTED 
and seeks another order card. 
See section 3.3. for feasibility processing. 
It examines the contents of the order card, 


If the order is eCMT, the comment has already been printed and 

the program starts looking for another order card, If it is an 

eHLT card, it stops at address 01D6. Pressing RUN causes the 
program to seek a new order card, If the order is eMDP, it reads 
and starta the memory dump routine (4th segment). If the order is 
oLPC or eDNA, it loads the associated program together with 
segments 5 and 6 and starta it. For all other orders, it loads the 

tape routine, the segment load routine, the disc routine (6th segment), 
it then loads and starts Pilot Two (7th segment). At this point 

Control ia transferred to Pilot Two. 


When an error or out of order condition occurs during a disc 
operation, Pilot One halts at address 01CA. Pressing RUN causes 


the operation to be tried again. 


Functions of Pilot 2 


Pilot Two carries out the following operations: 


a) 


It checks the logical. numbers of the tape units connected to the 
system, if any. 
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c) 


a) 
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This check is not carried out if a GUN 7/9 tape unit controller is 
being used, 


Load the logical disc unit number showing the initialized file at 
memory location 0080 and in the segment feed routine parameters. 
The physical number of the unit is obtained from Pilot Zero. 
If the logieal number is not included in the correspondence table 
(at address 016E), it prints the following message: 

51134 MAIN DISC NUMBER ERROR 
and halts at location 0000. 


Searches segments 2 tn17 of cylinder 0 for the program file label, 
i.e. the label with SD, LD or MD as its first characters. 
If the program label is not found, it prints the following message: 
5114 * PFL NOT FOUND 
and halts at location 0000. 
if the program file label is found, it searches the program file 
index for the program associated with the order. If the program 
does not exist, Pilot Two prints: 
5111 * ORDER UNKNOWN 
This sets the feasibility condition to "NO" and halts at location 
02A6. Pressing RUN restarts Pilot Zero. If, during the search, 
Pilot Two does not find the end of index character E, it prints: 


5112 * END OF PROGRAMS TABLE NOT FOUND 


This sets the feasibility condition to NO and halts at location 02A6. 
Pressing RUN restarts Pilot Zero. 
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e) Ifit has found the name of the program to be started in the index, 
Pilot Two transfers the program label address, located in the 
index, to the service area reserved for the segment load routine. 
It then sets all the memory that can be used by the programs to 
value 0A and starts the segment load routine. 


Ifa persistent error in disc operation occurs, Pilot Two prints: 
5101* D. UNIT N PERSISTENT ERROR 

This sets the feasibility condition to "NO" and halts at address 

02A6. Pressing RUN restarts Pilot Zero. 

If the dise unit signals out of order, Pilot Two prints: 


5103 * D. UNIT N OUT OF ORDER 


and halts at location 01DA, to allow the operator to put the unit 
back in service. 


If the unit is still out of order when an attempt is made to retry 


the operation, the feasibility condition is set to "NO" and the 
. program halts at 02A6. 


5.3. FUNCTIONS OF SEGMENT LOAD ROUTINE 


The Segment Load Routine searches for a program segment, loads it into 
memory, and starts it. The Segment Load Routine compares the segment 
number required with the last segment number read. If the comparison 
gives a less than or equal to result, the search starts from the beginning 
of the program; otherwise the search continues from the last segment 
started. For example, assume a program of 5 segments (numbered 1, 2, 
3, 4 and 5) and segment 3 was the last segment read. 


If the required segment is not found, the feasibility code is set to "NO" and 
the routine halts at location 0200. An error in dise operations also sets the 
feasibility code to "NO", but halts at location 02CA. Pressing RUN restarts 
Pilot Zero for both cases. 
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Error messages : 


5101 


5103 


5110 


5111 


5112 


x DISC UNIT N PERSISTENT 


ERROR 


x DISC UNIT N OUT OF 
ORDER 


x ORDER NOT EXECUTED 


x ORDER UNKNOWN 


x END OF PROGRAM 
TABLE NOT FOUND 
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\M HLT MESSAGES AND INSTRUCTIONS 


Persistent error on disc unit N. 
Processing halts at address 02A6. 
Pressing RUN starts search for a 
new order card, 


Disc unit N is out of order. 

The program stops at address 01DA 
until the operator puts the unit back in 
order. If the same message appears 
again when processing is restarted 
the program halts at address 02A6. 
Pressing RUN starts search for a 
new order card, 


The last order read cannot be 
executed. (Feasibility condition:NO). 
The program goes on to the next 
order card, 


The requested program is absent from 
the program file. Processing halts 

at address 02A6. 

Pressing RUN starts search for a 
new order card. 


The end character E is not present 
in the file index. 
Processing halts at address 02A6. 
Pressing RUN starts search for a 
new order card, 


5113 


5114 


x MAIN DISC NUMBER 
ERROR 


x PFL NOT FOUND 


DISC OPERATING SYSTEM 


The logical number of the unit initialized 
cannot be found, 


The program halts at address 0000. 
Restart Pilot 0 and repeat eDNA order. 


No program file is present in the 


initialized volume. 
Processing Halts at address 0000, 


HLT Instructions: 


HLT 
ADDRESS REASON OPERATOR ACTION 

0000 Blocking error, indicated by a 
printed message. 

012C Read error during Bootstrap Pilot 0 is restarted by 
execution. pressing RUN. 

01D6 Pilot One stopped by a HLT Press RUN. Pilot One will 
order. search for a new order card, 

O1CA Read error or disc unit Press RUN to retry operation 
out of order in Pilot One. 

O1DA | Dise unit out of order in Correct the condition and 
Pilot Two. press RUN. 

02A6 | A printed message indicates 


the reason for the halt, 


42 


DISC OPERATING SYSTEM 


HLT 
| Address REASON OPERATOR ACTION ] 
1 
02C0 Required segment not found. Press RUN to restart Pilot 
Zero. The feasibility con- 
dition is "NO", 
02CA | Disc unit error in segment Press RUN to restart Pilot 
load routine, Zero. The feasibility 
condition ig "NO". 
01cc Two or more tape units with Press RUN to retry test. 
the same physical number. To continue without a test, 
set SWITCH 2 and press 
RUN. Another HLT takes 
place at address 01CC so 
that the operator can set 
SWITCH 2 to its original 
position. 
5.5. PILOT 0 RESTART 


When they have been executed, all the programs jump at address 02A8 (x) 
(decimal, 680) where the instruction that restarts Pilot 2 is located. 


If the system is MD-controlled, however, the instruction used to start 
segment 99 is at this address. Segment 99 will in turn start the Monitor. 


(x) This jump is made in the user programs by means of the macro-statement 
STOP (see APS I Language manual). 
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During the execution of a DOS program, if errors are encountered which 
block the execution or invalidate the results, the program jumps at 
address 02A2 (674 decimal); the instruction setting the feasibility condition 
to NO is at this address, The program then halts at address 02A6. Pilot 0 
is restarted by pressing RUN. 


In case of error a user program may also jump at address 02A2 instead 


of 02A8. This jump may be used to block the execution of MD programs 
which are linked to the user program. 


5.6. MASTER DISC INITIALIZATION an 


The Master Disc is initialized by starting Pilot 0. As has already been 
seen in the case of the System Disc, Pilot 0 stores and starts the 
Bootstrap program. 


The only difference compared with initializing the System Disc is that 

Pilot 1 checks the content of memory location 0032 before reading an 2) 
order card. If this content is 01, it means that the card has already been 

read by the Monitor of the previous program. In such case, Pilot 1 resets 

the content of this location to 00 and then goes on to check the order card 

which is already in the read area. 


Except for this difference, the MD runs in exactly the same way as the 
SD until the aPRL card is read. This card starts the first user program. 


The type-1 program pertaining to the ePRL order is different from the O35 
one present in the System Disc, Before starting the required program, it 
modifies the memory locations 02A8 - 02AF by substituting a jump te call 
segment 99 in place of the Pilot 0 restart jump: 
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MONITOR OPERATION 


The Monitor may carry out various functions according to the options 
specified when the MD is generated. Its running conditions depend 

on the preparation code written in segment 99 of each program. These 
running conditions may be one of the following: 


1. Start a type 3 program selected at the time of MD generation. 

2. Start a type-3 program selected according to how Switch 2 is 
positioned; the choice is made between two programs indicated while 
the MD is being generated. 

3. Read an order card. I this is a ePRL, the Monitor starts the 
program indicated; otherwise it starts Pilot 0 after setting to 01 the 
value of memory location 0032. 

4, Execute the order eMDS (Master Disc Stop) at end of processing. 

5. Start a type-3 program selected by the same program to which segment 
99 belongs; the name of the program is stored in the first location of the 
card read area, 

The Monitor first checks the feasibility condition. If it is NO, it starts 

Pilot 0; then the linking provided by the preparation codes 1, 2 and 5 does 

not take place. 

If the preparation code is 4, the order eMDS is still executed. 

If the feasibility condition is YES, the Monitor prints the following message: 
7599 x END OF PROGRAM X 


where X is the name of the program that has just been executed. Then the 
Monitor follows different ways depending on the preparation code: 
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Preparation code 1 

It prints the following message indicating the program to be started. 
7521 »% NEXT PROGRAM IS X 

It then seeks and starts the program mentioned. 

Preparation code 2 


It prints the following message, on the basis of which the operator 
will position Switch 2 


7522 x NEXT PROGRAM IS X WITH SWITCH 2 OFF/Y WITH 
SWITCH 2 ON 


The Monitor then comes to a HLT at address 01D8 and waits for 
operator action. The operator must position Switch 2 as required : i.e. 
he must turn on the switch if program Y is to be executed and turn 


it off if program X is to be executed. 


Atter pressing RUN, causes seeking and starting of the program 
selected. 


Preparation code 3 
The Monitor first prints out the following message: 

7523 x NEXT PROGRAM SELECTED BY ORDER CARD 
and goes on to seek an order card. 


If the order cards @PRL it is printed and its serial code, if any, is 
moved to the appropriate storage area. 


The Monitor then checks the validity of the ePRL card and of any LBC 
cards, which may be present. 
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If any errors are found, it prints one of the messages listed in the next 
pages and then jumps at address 02A2 (feasibility condition: NO) after 
resuming the Pilot 0 restart jump at address 02A8, 


If no error is found it seeks the program mentioned in the ePRL card; if 
there are LBC cards the program file table, if any, is updated, The 
Monitor then starts segment 01 of the program proper. The execution of 
segment 00 is not needed since the start conditions are already contained 
in the ePRL card, 


Preparation code 5 


The Monitor prints the following message, which mentions the program to 
be started. 


7525 x NEXT PROGRAM X SELECTED BY ENDED PROGRAM 
The name of this program has been placed in the read area by the program 
that has just been executed. The Monitor then seeks and starts the 
program to be executed. 


The following messages may appear during Monitor execution: 


7501 x UNIT X PERSISTENT ERROR 
Persistent error in unit X. The Monitor halts at address 02A6. 
Feasibility condition: NO. Pilot 0 is restarted by pressing RUN. 
7502 x UNIT X OUT OF ORDER 
Unit X is out of order. The Monitor halts at address 02A6. 
Feasibility condition: NO. Pilot 0 is restarted by pressing RUN. 
7510 x PROGRAM NNNNNN NOT FOUND 


Indicates that the program to be started has not been found, 
The Monitor halts at address 02AC. 
Feasibility condition: NO, Pilot 0 is restarted by pressing RUN. 
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7511 x SUB-ORDER CARD ERROR 


The identification code of a detail card is incorrect. The Monitor 
halts at address 02A6. 

Feasibility condition: NO. 

Pilot 0 is restarted by pressing RUN. 


7512 x SUB-ORDER CARD COLUMN NN ERROR 

The field starting from col. NN of a detail card is incorrect. 
7513 x YYDDD/START OF PROGRAM X 

Indicates start of a program. The day's date is printed. 
7515 x ORDER CARD COLUMN NN ERROR 

Error in column NN of card #PRL. 


7516 x» CHECK~POINT FILE TOO SMALL 


The size of volume zone reserved for the CHECKPOINT file is not 
sufficient. The Monitor halts at address 02A6. Feasibility condi- 
tion: NO. 

Pilot 0 is restarted by pressing RUN. 


7521 x NEXT PROGRAM IS X 


Indicates the next program to be executed. 


7522 x NEXT PROGRAM IS X WITH SWITCH 2 OFF/Y WITH SWITCH 
20N 


Operator action is requested for selecting the next program to be 
executed, 

If program X, press RUN; 

if program Y, turn on Switch 2, then press RUN. 
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7523 x NEXT PROGRAM SELECTED BY ORDER CARD 


Indicates that the next program to be executed will be specified 
by an order card. 


7525 x NEXT PROGRAM X SELECTED BY ENDED PROGRAM 


Indicates the next program to be executed. 
This program is selected by the program that has just been 
executed. 


7599 x END OF PROGRAM X 


Indicates that program X has been executed. 
While order eMDS is being executed, the following message may appear: 
7601 x MASTER DISC STOP 


Processing halts at address 01D6. 
Pilot 0 is restarted by pressing RUN. 


Any HLT requested before a program start takes place at address 01D2. 


49 


DISC OPERATING SYSTEM 


CHAPTER 6. SYSTEM DISC GENERATE 


6.1. 


6.2. 


GENERAL 


To generate a System Disc means to personalize or adapt a standard 
System Disc to the desired configuration. Such generation is done by the 
program eSDG written on the standard System Disc. 


Two methods are provided for calling and initiating the System Disc 
Generate program: 


a) The order card eSDG 

b) The "Load Order by Cards" program punched on cards, 

Method a) is used when the configuration ineluded in the Standard System 
Dise is the same as the one actually used by the system for generation; 
otherwise, the program Load Order by Cards is used. 

Method a) is explained in the second part of this manual by the DOS 


control orders; 
method b) is described in the following paragraph. 


"LOAD ORDER BY CARDS" PROGRAM 


6.2.1. Funetion 


This program, punched on cards, core loads and initiates the eSDG 
program to personalize the System Dise on which the eSDG program 
itself is written. It is made use of a Standard SD containing a Basie 
Program which may correspond to 2 configuration other than the one 
actually used by the system. 
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Zz. System Unit Required 

The following peripherals are required: 

-  adisc unit containing the standard System Disc to be personalized 
-  acard reader 

- aprinter. 

3. Parameter Card 

The parameter card is read-in as a patch card at the end of the Load 
Order by Cards program and precedes the end of program card (FF - 
punched in columns 70 and 80). It contains the parameters required 


by the program itself and defines the system configuration, 


It has the following format: 


Col, 1- 4 program code 0896 
Col. 5- 6 patch length in hexadecimal: 06 
Col. 7-10 patch first character address in hexadecimal: 0200 


Col, 11-12 reader type: 


¥1=CRZL00 CRZ120 
#2 = to be assigned 

#3 = to be assigned 

¥4 = CRP1O0 


Col. 13 - 14 reader connection number (in hexadecimal) or blank 
when the reader hag an integrated controller (that ia 
#1 in columns 11 and 12) 


Col. 15-16 printer type: 


KL = PRINTER 300, PRINTER 600 
¥2 = PRINTER 1100 
#3 = MB (PRT105) 
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¥4 = to be assigned 
U5 = to be assigned 


Col, 17-18 printer connection number (in hexadecimal) or blank 
when the printer has an integrated controller (that is 
¥i in columns 15 and 16. 


Col, 19 - 20 punch code: 
blank = Hollerith eode 
any punch = Bull code 


Col, 21 - 22 dise unit connection number (in hexadecimal) 


Col. 23 - 80 not used. 
4. Description and execution 


The Load Order by Cards program located at address 1800 (decimal) 
ig a segment which includes the segment-load routine and the dise 
subroutine in addition to the program proper. 


The program generates in the store some of basic program segments 
adding to the segment-load routine and the disc routine the read and 
print routines retrieved from the System Disc eSDG routine and 
adapts them to the configuration accerding to the parameter card; the 
program also sets up control to the tape and disc management 
subroutines and HLT statements to signal disc errors, Then it loads 
and initiates the eSDG routine to personalize the System Disc. 


Using the Load Order by Cards program requires the following cards: 


- Loader 


- Load Order by Cards program with parameter card inserted 
immediately before the end of program card FF 


- Detail cards for the eSDG control order. 
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6.2.5. Checks and error messages 


6.2, 


On the basis of checks performed on the disc unit the program may halt 
at address O1E0 or O1E6. 


When an error has been detected in one of the two fields of the order 
card which concern the type of reader or printer the program halts 
at address 0206, 


If the eSDG program ig not recorded on the System Disc, the program 
halts at address 020C. 


At end, the program halts at address 0212 and prints out the 
following message: 


4099 » END OF LOAD ORDER BY CARDS 
6. Example 


A System Disc is to be adapted to a configuration made up of an 8,192 
location memory connected to a CRP100 (connection number 40 in 
hexadecimal) used as card reader/punch with Hollerith punch code, 

a PRT100 and a DSS130 (connector number 29 in hexadecimal), 


The following cards must be punched: 
1. Order card 


Col. 1- 4 = 0396 
Col. 5-6 - 06 
Col. 7-10 = 0200 
Col. 11-12 = 4 
Col. 13-14 = 40 


i 
= 


Col. 15-16 
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Col. 17- 20 = blank 
Col, 21 - 22 = 20 
Col. 23 - 80 = blank 


eSDG program detail cards 
a. RDC Card 


Col. 1- 4 BRDC 
Col. 5- 6 Be 
Col. 7- 9 064 
Col. 10 - 80 blank 


b, PRC Card 
Col. 1- 4 BPRC 
Col. 5- 6 HI 


Col. 7-80 blank 
e. DSC Card 


Col. 1- 4 BDSC 
Col, 5- 6 HI 
Col. 7- 8 02 
Col. 9-11 032 
Col. 12-14 033 
Col. 15 - 80 blank 
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d. PNC Card 


Col. 1- 4 MPNC 
Col. 5- 6 BL 
Col. 7~ 9 064 
Col. 10 - 80. blank 


e. CDC Card 


Col. 1- 4 KCDC 
Col. 5- H 
Col, 6-80 blank 


f MCC Card 


Col. 1- 4 BMCC 
Col. 5- 6 08 
Col, 7-80 blank 


g. END Card 


Col. 1- 4 KEND 
Col, 5-80 blank 


Cards must be feed into the card reader in the following order: 


- Loader 


~ Load Order by Cards program with the parameters card 
preceded by the object program cards and immediately 
followed by the FF card 


- eSDG program detail cards. 
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eDNA DISC NUMBER ASSIGNMENT 


FUNCTION 


To assign a logical dise number to a disc unit, These two numbers may 
or may not be the same. 

A table relating logical dise number to physical disc units is set up in 
the memory at initial address 016E. 


SYSTEM UNITS REQUIRED 


The program uses the following peripherals: 


-  adisc unit for the System Disc 
- aprinter. 


PARAMETER CARD 


Dise Number Assignment requires only the order card with the following 
format: : 


Col, lto 4 Order eDNA identification code. 


Col. Sto 9 Not used. 


Col. 10 to 19 Logical disc unit numbers. The logicat number of the 
first unit,is punched from column 10 on. Where a 
unit has the same logical/physical number, this 
column is not punched. An asterisk (x) is punched in 
the corresponding column for a disc assigned as out 
of order, 

Columns for unconnected disc units are left blank. 


Col. 20 to 72 Not used. 
Col. 73 to 80 Not used. 
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DESCRIPTION AND EXECUTION 


The Dise Number Assignment program has only one segment which is 
stored at memory address 5024 (decimal) and is located on cylinder 0 of 
each disc. 


The program creates a table relating logical disc unit numbers to physical 
disc units (this table starts at address 016E); i.e. the physical number 
associated with logical dise unit number 1 is located at address 016E, 

ete. The character FF signifies that a unit is not connected or is declared 
as out of order. 


CHECKS AND ERROR MESSAGES 


The Disc Number Assignment program checks the operation of peripheral 
units and the validity of parameters punched on order cards. The following 
messages are printed to indicate errors encountered: 


0801 = D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying on a logical disc 
unit N. 
Program terminates; feasibility condition "NO". 


0802 x D. UNIT N OUT OF ORDER 


Unit N indicated as out of order, The program causes the printer 
to move the paper in the printer to a new page and the program 
halts at location 01DA: 


Pressing RUN retries the operation that caused the signal. If the 
signal repeats, the program terminates. Feasibility condition 
‘NOM, 

0803 x D. UNIT N PERSISTENT ERROR 


Positioning error on unit N. 
Program Terminates, Feasibility condition: "NO". 
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0810 x ORDER CARD ERROR 


In addition to the asterisk, non-numeric punch in columns 10 to 19 
of the order card. 
Program terminates; feasibility condition: "NO". 


0811 x MULTIPLE NUMBER 


The same logical disc number has been assigned to more than one 
physical dise unit. 
Program terminates: feasibility condition: "NO". 


0812 x NOT DISC 


A logical disc number has been assigned to an unconnected 
physical dise unit. 
Program terminates; feasibility condition: "NO". 


0813 x» PROCEEDING IMPOSSIBLE INSERT PILOT ZERO 


Message printed after each of the above error messages. It is a 
reminder that for an error in order eDNA execution, the system 
must be restarted. 


EXAMPLE 


For a system with 4 disc units connected, where the logical disc number 1 
ig to be assigned to the first disc unit (physical unit number 0) and the 
fourth unit (physical unit number 3) is to be ignored, the order card is 
punched as follows: 


Col. 1to 4 
Col. Sto 9 
Col. 10 
Col, 11 
Col. 12 
Col, 13 
Col. 14 to 80 


DNA 
+B 


Re Rowe 
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eINT INITIALIZE 


1. FUNCTION 


To read the day's date into memory locations 40 to 45 (decimal) and data, 
which may be supplied by the user, in memory locations 52 to 83 (decimal) 
it sets the checking area (decimal locations 50 and 51) to zero (binary) and, 
if desired, prints and checks the serial numbers of volumes mounted on the 
disc units to be initialized. 


2, SYSTEM UNITS REQUIRED 


The following peripherals are required: 


- a System Disc unit, 


- the number of dise units (maximum of three) specified on the order 
card, 


~ a printer. 
3. PARAMETER CARDS 
The Initialize program requires only one order card with the following 


format: 


Col lto 4 order identification code: e INT 
Col, 5to10 day's date in the form: BYYDDD 


Col, 11 to 16 serial number of the SD if checking required; blank if 
no checking required. 


61 


4, 


Col 


Col. 


Col, 


Col. 


Col. 


Col, 


Col 


~17 


18 to 23 


24 to 30 


31 to 37 


38 


39 to 70 


. Th to 80 


DISC OPERATING SYSTEM 


logical disc number of the first volume for which a 
label is to be written. 

Blank if no label checking is required. 

Tn all order cards having WD (Work Disc) punched in 
columns 5 and 6 reference will be made to the unit 
whose logical number is punched in this columns. 
The eAPS order also refers to this unit each time a 
Work Disc is being used (option 3, card column 5). 


Serial number of the volume specified in column 17. 
Blank if no serial’ number checking required. 


Same as columns 17 - 23 if two disc units are to be 
initialized at the same time. 


x for user data to be transferred to the portion of 
the memory reserved for this purpose. 


¥ otherwise, 


user data (optional); blank unless there is an asterisk 


" # in card column 38. 


not used, 


DESCRIPTION AND EXECUTION 


The Initialize program is made up of a single segment at address 2048 
(decimal), 
The card is first checked for validity, requested transfers are carried out, 
and the following information is printed: 


- the message DISC LABEL OF UNIT N followed by the volume label of 


the 


- the message AVAILABLE CYLINDERS TABLE followed by the free area 
table of the SD, 


sD, 
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~ the message PROGRAM FILE LABEL, followed by the label, 


- and, finally, the labels of other discs, if requested. 


CHECKS AND ERROR MESSAGES 


Messages ere printed as a result of program checks. Note, however, that 
if there is an error during program execution processing cannot continue: 
a HLT stops the program at address 0000, followed by a jump at the same 
address; it is then necessary to reload Pitot 0 and restart the program. 


The following is printed at the end of each message: 
0318 x PROCEEDING IMPOSSIBLE - INSERT PILOT ZERO, 
Error messages are as follows: 


0301 x D. UNIT N PERSISTENT ERROR 


Persistent error during reading on dise unit N, 


0302 x D. UNIT N OUT OF ORDER 


Dise Unit N is out of order. The program causes the printer 
to slew the paper to a new page and processing halts at location 
O1DA. Pressing RUN retries the operation that caused the 
message. if there is a new message, the program stops. 

0303 xD. UNIT N PERSISTENT ERROR 


Persistent error in positioning of dise unit N. 


0310 x DATE CODE ERROR 


Error in the card area containing the date (this might be a 
character other than # in the first column; or an alphabetic 
character in the next columns). 
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0312 % USER DATA CODE ERROR 
A symbol other than x or # is punched in column 38 of the order 
card, 
0317 x UNIT N DISC SERIAL NUMBER ERROR 


The serial number punched on the order card does not agree with 
the serial number of the volume mounted on disc unit N. 
The program prints the volume label on the next line. 


EXAMPLE 


Assuming that the serial number of the SD is to be verified as "1 23 4 5" 
that the labels of the two other volumes on disc units 0 and 4 are to be 
printed, that the serial number of the volume mounted on disc unit 0 is to 
be checked and that all user data areas are to be blank-filled, the order 


Unit N is not part of the system or is out of order. 


card should be punched as follows: 


Col, 
Col. 
Col. 


Col. 


Col. 
Col, 
Col. 
Col, 
Col. 
Col. 
Col. 


lto 4 
5 to 10 

11 to 16 
17 

18 to 23 

24 

25 to 30 

31 to 37 

38 

39 to 70 

TL to 80 


oINT 
B6ET155 
12345 
Qo 

23456 
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eIND INITIALIZE DISC 


NC TION 


To execute volume serialization by recording headers and reproducing 
eylinder zero from SD. 


SYSTEM UNITS REQUIRED 


The Initialize Dise requires the following peripherals: 


- a System Dise unit 
- adisc unit on which the volume to be serialized is mounted 


- a printer. 


PARAMETER CARD 


The Initialize Disc requires only the order card with the following format: 


Col. lto 4 Order identification code: eIND 
Col. §to010 Not used 


Col. 11 Logical disc unit number on which volume to be 
serialized is mounted 


Col. 12 to17 Volume serial number 
Col, 18 to 27 Volume name 

Col. 28 to 72 Not used 

Col. 73 to 80 Serial code (if desired). 
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DESCRIPTION AND EXECUTION 


This program is made up of a single segment stored at memory location 
2048 (decimal). 


The sector headings of the entire volume are written sequentially from 
00000 to 19999, 


Cylinder zero is written in the same format ag the one on the SD: 

sectors 00000 and 00001 are reserved for diagnostic programs, sector 
00018 (physically the third sector contains the volume label, i.e. 
information punched on the order card; sector 00019 contains the free area 
table and designates cylinders 1 to 99 as free, except those containing a © 
persistent error as revealed during the writing of headings; sector 00002 

to 00017, reserved for the file labels, contains dummy labels with an 
indication of absent files (V in position 54); sectors 00020 to 00199 are 
duplicated from the corresponding sectors on the SD. 


Then all sectors of cylinders 1 to 99 are written with a standard configuration 
of characters that are readable in both 8-bit and 6-bit mode. 

Thus even though the file is read before being written, no dise unit error 

will occur. 


Headings are written one cylinder at a time as follows: 


- writing in "direct seek" 


sc verifying in ‘return to home seek" 


It should be noted that only one volume can be serialized at a time. 
Consequently there must be one eIND card for each volume to be serialized. 
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CHECKS AND ERROR MESSAGES 


The eIND (NITIALIZE DISC) program checks the operation of disc units and 
the validity of parameters punched on the order card. 


Errors encountered are indicated by the following messages: 


0201 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading disc unit N. 
Program terminates; feasibility condition: NO. 


0202 x D. UNIT N OUT OF ORDER 


Dise Unit N is indicated as out of order. 

The program causes the printer to move the paper to a new page 
and the program halts at location 0LDA; pressing RUN retries the 
operation that caused the signal. If the signal repeats, the program 
terminates and the feasibility condition is NO. 


0203 x D. UNIT N PERSISTENT ERROR 


Persistent positioning error on unit N. 
Program terminates; feasibility condition: NO. 


0210 x D. UNIT N NUMBER ERROR 


Error on the order card: column 22, containing the logical dise 
number of the unit to be serialized does not contain a numeric 
punch, 

Program terminates; feasibility condition: NO. 


0211 x» TRACK XXXXX WITH PERSISTENT ERROR CYLINDER YY 
NOT AVAILABLE 


Persistent error in writing headings on the track whose first 
segment address is XXXXX. The program indicates on the free 
area table that the whole cylinder YY, on which this track is found, 
is not available. Program continues; feasibility condition: YES. 
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0212 x» PERSISTENT ERROR ON CYLINDER 0 
Persistent error on cylinder zero, Program terminates; 
feasibility condition: NO. 

0213 x D. UNIT N NUMBER ERROR 


The disc unit indicated in order card column 11 is not part of the 
systems. 


Program terminates; feasibility condition: NO. 
0214 x IMPOSSIBLE INITIALIZATION 


Overflow of sector . 00019 containing the free area table (in this ey 
case, during volume serialization, the number of blank cylinders 

was so great that the volume itself was divided into more than 24 

free areas), 

Program terminates; feasibility condition: NO. 


EXAMPLE *) 


To serialize 2 volume mounted on unit 1 with volume serial number 00012A 
and the user name O.G.E., the order card, which is not serially connected 
with other cards, should be punched as follows: 
Col. lto 4 eIND 
Col. 5to10 4B... B ° 
Cot. 11 1 
Col, 12 to 17 00012A 
Col. 18 to 27 0.G.E. 
Col. 28t072  B... 
Col. 73t080 Bb... # 
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INITIALIZE DISC by CARD 


This program initializes a volume, i.e. writes all disc sector headers and 
creates the cylinder zero, using the informations read from a data card 


deck, 


SYSTEM UNITS REQUIRED 


This program uses the following peripherals: 


- a disc unit,on which are mounted the SD, in the first phase; the volume 
being initialize, in the second phase 


-  acard reader, to read the data card deck 


- @a printer 


-  @ punch, 


if in the first phase the data card deck is to be punched. 


PARAMETER CARDS 


This program requires only the order card, with the following format: 


Col. ito 4 
Col, 5to10 
Col. 11 


Col, 12to 17 
Col. 18 to 27 
Col. 28 to 72 
Col. 73 to 76 
Col. 77 to 80 


eID 

not used 

P, if in the first phase, the data card deck is to be 
punched, otherwise blank 

serial number of the volume 

user name 

not used 

optional ID code 

not used 
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4, DESCRIPTION AND EXECUTION 


This program is made up of a single segment with start address 1800 (decimal). 
Program execution is made up of two successive phases: 


~ Initially, after the System Dise is mounted, the program is loaded and its 
execution is started by Pilot 2. If option P ig present in col. 11 of the 
order card, the contents of Cylinder Zero of the System Disc, with a 
structure similar to that of a program punched with eAPP, are punched 
on cards, 
BPbb (Basic Program) code is punched in the first four columns of these 
cards. 


At the end, the program halts after printing message 1817. 


- In the second phase, after substituting the SD with the volume being 
initialized, the card reader is loaded with the data card deck and the 
initialization phase begins, 


The volume is made available for writing in sector mode, The sector 
headings of the entire volume are written sequentially from sector 
00000 to 19999. Cylinder Zero is written in the following way. 


sectors 00000 ~ 00001 are reserved for diagnostic programs 


sector: 00018 {physically the 3rd sector) contains the volume 
label, using informations punched on the order 
eard. 

sector 00019 contains the free area table and designate cylinders 


1 to 99 as free, except those containing a 
persistent error as revealed during the writing 
of heading 

sector 00002 to 00017 reserved for the file labels; containing dummy 
labels with an indication of absent files (V in 
position 54) 

sector 00020 to 00199 are written, using the data. card deck, as the 
corresponding sectors on the SD 
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Then all sectors of cylinders 1 to 99 are written with a standard confi- 
guration of characters that are readable in both 8-bit and 6-bit mode. 


Thus even though the file is read before being written, no disc unit 
error will occur. 


It should be noted that only one volume can be serialized at a time. 


Consequently there must be one eIDC card for each volume to be 
serialized. 


5, CHECKS AND ERROR MESSAGES 


Errors encountered are indicated by the following messages: 


1801 * D. UNIT N PERSISTENT ERROR 


Persistent error in reading dise unit N. 
Program terminates; feasibility condition: NO. 


1802 * D. UNIT N OUT OF ORDER 


Dise Unit N is indicated as out of order. 

The program causes the printer to move the paper to a new page 
and the program halts at location 01DA; pressing RUN retries the 
operation that caused the signal . If the signal repeats, the 
program terminates and the feasibility condition is NO. 


1803 * D, UNIT N PERSISTENT ERROR 


Persistent positioning error on unit N. 
Program terminates; feasibility condition: NO. 


1810 * ORDER CARD ERROR 


A wrong punch is present in column 11 of the order card, Program 
execution terminates; feasibility condition: NO. 
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1811 * TRACK XXXXX WITH PERSISTENT ERROR CYLINDER YY NOT 
AVAILABLE 


Persistent error in writing headings on the track whose first 
sector address is XXXXX. The program indicates on the free 
area table that the whole cylinder YY, on which this track is 
found, is not available. Program continues; feasibility condition: 
YES. 


1812 * PERSISTENT ERROR ON CYLINDER 0 
Persistent error on cylinder zero. Program terminates; feasibility 
condition: NO. 

1814 * IMPOSSIBLE INITIALIZATION 


Overflow of sector 00019 containing the free area table {in this 
ease, during volume serialization, the number of blank cylinders 
was so great that the volume itself was divided into more than 24 
free areas). 

Program terminates; feasibility condition: NO. 


1815 * NO PUNCHER 


No puncher is connected to the system when P character is punched 
in col. 11. Program execution terminates; feasibility condition:NO. 


1816 * PUNCH ERROR ON CARD ** 
Punch error on the card which is printed with two asterisk aside. 
Program execution goes on; feasibility condition: YES. 


1817 * REPLACE 8.D, DECK ON CARD READER 


Program HLT 01CC signals the end of the first phase. At this 
point the user should substitute the SD with the volume to be 
initialized and load the data card deck on the card reader. By 
pressing START the program re-continues; feasibility condition: 
NO, 
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1818 * CARD ADDRESS ERROR 


The memory address punched on the last card read does not 
correspond to the sum of the address plus the length punched on 
the preceding card. Program halts; feasibility condition: NO. 


1819 * CARD SEQUENCE ERROR 


The last card read is out of sequence. Program execution halts; 
feasibility condition: NO. 


1820 * PROGRAM CODE ERROR 


The program code punched in the first four columns of the last 
card read is not BP¥#; program execution halts; feasibility 
condition: NO. 


1899 * END OF INITIALIZE DISC BY CARD 
End of program 


EXAMPLE 


To initialize a volume, writing serial number 012345 and the user name 
HONEYWELL, using a data card deck already available at the Center, 


‘The contents of the order card is the following 


Col. 1to 4 
Col. Stoll 
Col. 12to17 
Col. 18 to 27 
Col. 28 to 80 


IDO 

blank 

012345 
HONEYWELL. 
Blank. 
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oFLW FILE LABEL WRITE 


1, FUNCTION 


To insert new file labels (data or programs) on disc while preparing 
reserved volume areas of the file for future use; to delete or update file 
labels included in specific volumes and to alter the area reserved for these 
volumes at the same time. 


2. SYSTEM UNITS REQUIRED 


The File Label Write program uses the following peripherals: 


- one or two dise units to write or modify file labels or delete existing 
files 


- a System Disc unit 
- a printer 
- acard reader (to insert detail cards). 


3. PARAMETER CARDS 


3.1. . ORDER CARD 
The format of the order card is: 


Col. Lto 4 Order identification code: eF LW 
Col. 5 to 72 Not used 
Col. 73 to 80 Serial code (if desired). 
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To insert a new label into the file table, the detail card FLI is requi- 
red; to update the file table, the detail card FLU is required; to delete 
a label from the file table, the detail card FLD is required. 


3.2.1, 


FLI card (File Label Insert) for insertion of new labels. 


The format of this card is: 


Col. 
Col. 


Col. 
Cot. 


Col. 


Col. 
Col. 
Col. 


1lto 4 
Sto 6 


7to 12 
13 


14 to 25 


26 to 31 
32 to 35 
36 


Identification code: 6 F LI 


Logicat disc number, punched in column 6 of the 
unit on which the volume concerned is mounted; 
punch SD for a System Disc, 


Volume serial number 
Type of file 


~  § = Sequential 
- R-=Random 
- P= Program 


File name - if type P columns 14 - 15 must contain 
SD for a System Disc, or 

MD for a Master Disc, or 

LD for a Library Disc. 


Serial number of the first volume of the file. 
Sequence number of the volume within the file. 


File code indicating volume location within the file, 
This may have one of the following values: 


-  F = last volume in the file 
-  V= file continues on other volumes. 
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Col. 


Col. 


Col. 
Col. 


Col. 


Col, 


Col. 


Col. 


Col. 


37 


38 - 43 


44 to 49 
50 to 51 


52 to 53 


54 to 57 


58 to 59 


60 to 61 


62 to 63 
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Recording mode 


- 0: 6-bit sector mode 
1: 8-bit sector mode 

- 2: 6-bit full-track mode - 
3: 8-bit full-track mode 


File creation date; if blank, the day's date located 
in the memory is used by the program. 


Retention date; if blank, creation date is used, 


Initial cylinder of the first part of file (if the letter . 
A is punched in card column 50, the program 
selecta the cylinder according to the free area table). 


Number of cylinders to be reserved for the first part 
of file. 


Same as columns 50 to 53 for second part of file (if 
required). It should be noted that these columns 
remain blank for program files or where the choice 
of file area is requested from the program. In the 
latter case, any division of the file into two parts is 
earried out by the program if there is no area large 
enough to contain the whole file, 


Initial cylinder of overflow area (if the letter A is 
punched in column 58, the overflow area is selected 
by the program). This parameter is only valid for 
type § files. 


Number of cylinders for overflow area; this parameter 
is only valid for typeS files. 


Cylinder for index; this parameter is only valid for 
type S files. If the lotter A is punched in column 62, 
the cylinder is selected by the program. 
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Not used. 

It should be noted that if automatic selection of file 
areas is requested, all other areas must be selected 
automatically. 


3.2.2, FLU Card (File Label Update) to update an existing label 


The format of an FLU detail card is as follows: 


Col. 
Col. 


Col. 
Col. 


Col. 
Col. 


Col. 


Col. 


lto 4 
Sto 6 


7to 12 
13 


14 to 25 
26 to 49 


50 


51 


Identification code: § F L U 


Logical disc number, punched in column 6, on 
which the volume containing the label to be 
modified is located, punch SD if the volume is a 
System Disc. 


Volume serial number. 


Type of file on which the label to be modified is 
located. 


File name of label being updated. 


These columns correspond to the field breakdowns 
of the FLI cards and contain new data to be inserted 
in new labels. Leave any field not to be updated 
blank. 

Modification of the recording mode (Col. 37) is not 
permitted. 


- To reduce the reserved area of the file 
to the dimensions it actually takes up. 
Not valid for the overflow area of a 
sequential file or a random file. 


- $8 Otherwise. 
Blank 
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Col, 52 to 53 Number of cylinders to be assigned to the file; 
thia number may be greater or smaller than the 
one already assigned to the file. 

If column 50 contains an asterisk #, this area is 
left blank. Left blank, as well, if there is no 
change in the number of cylinders reserved for 
the file. 


Col. 54 In increasing the number of cylinders reserved 

for the file, it may be necessary to create a 
second area. 
If an asterisk x is punched in this columns, the 
program automatically selects the second part 
of the file. Blank, if the file is not to be divided 
into two parts. 


Col. 55 to 57 Not used. 


Col. 58 to 59 Number of the initial cylinder for overflow 
area to be created (if necessary). 


Col. 60 to 61 Number of cylinders assigned to the overflow 
area, whether for updating or creation. 


Col. 62 to 63 Cylinder number to be reserved for a type S 
file index, if necessary. 


Col, 64 to 75 New file name (if desired). 
Col. 76 to 80 Not used. 


3.2.38. FLD Card (File Label Delete) to delete an existing label 


The format of the detail card used to delete an area previously 
reserved for a file in the volume is as follows: 


Col. ito 4 Identification code: 6 F L D 


Col. Sto 6 Logical dise number, punched in column 6, on 
which the volume containing the label to be 
deleted is located; punch SD if the volume is a 
System Disc. 
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Col. 7 to 12 Volume serial number. 
Col. 13 Type of file to be deleted (S, Ror P) 


* if all the files on the volume are to be deleted;. 
if columns 5 and 6 contain SD, all the files are 
deleted from the System Dise except the program 
file. 


Col. 14 to 25 Name of the file to be deleted (if there is no asterisk 
in column 13). 


Col. 26 to 80 Not used. 


3.2.4. End of order card 


A KEND card must be placed at the end of all detail cards. 


DESCRIPTION AND EXECUTION 


The program is made up of four segments stored at location 1800 (decimal). 


To write a new label, the appropriate area is sought and the free area table 
is consulted; the new label is then created and written, To update or delete 
a label, a check must firat be made to be certain that this label exists. 


The program prints the new file labels to be written, modified or deleted. 
To delete a program file, location 53 of the corresponding label contains 
the character V, which indicates that the file is deleted and that the 
locations are now free. 

To write a new file, the program writes the new label in the sectors 


reserved for this purpose on the first track of cylinder zero; the free area 
table is updated and, for files to be written in the full-track mode, headings 
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of those tracks reserved for the file are written. To write an R type file, 
the program writes an "AO" (hexadecimal) end of page code at the beginning 
of all usable pages. (By usable pages is meant file sectors when writing 
in the sector mode and file tracks when writing in the full-track mode). 


The program reacts in the same way to modify the dimensions of an 
existing file. 
To summarize, the program fulfills the following functions 


a) creation of new file labels and preparation of volume areas 


b) deletion of the volume of certain files or of complete existing files 
e) deletion of the SD for all except program files 


d) modification of the size of the volume area reserved for a specific 
file or for its overflow area 


e) modification of one or more parameters on the HDR1 label 


f) addition or deletion of the overflow area or of an index cylinder. 
In addition, the program will always carry out the following operations: 


- if labels have been deleted, it rearranges the valid labels so 
that they are in the first area reserved for them, 


- if changes have occured in the free areas, the corresponding table 
is updated so that the first area indicated is always the largest. 


5. CHECKS AND ERROR MESSAGES 


The program not only checks the peripheral units but also checks the order 
eard and detail card areas, both physically and logically. 
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When an error is found, one of the following messages is transmitted: 


0701 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading, writing or verifying logical disc unit 
N. Program terminates; feasibility condition: NO. 

0702 x D. UNIT N OUT OF ORDER 


Disc unit N signatled out of order. The program causes the printer 
to move the paper to a new page and the program halts at location 
01DA; pressing RUN retries the operation that caused the message. 
If the signal repeats, the program terminates. Feasibility condition: 
NO. 


0703 xD. UNIT N PERSISTENT ERROR 
Positioning error on unit N. 
Program terminates; feasibility condition: NO. 
0710 x SUB-ORDER CARD ERROR 


Wrong identification code on card read. 
Program terminates; feasibility condition: NO. 


0711 x SUB-ORDER CARD COLUMN N ERROR 


The area beginning with column N of the previously printed detail 
ecard is wrong. 
Program terminates; feasibility condition: NO. 


0712 xD. UNIT N NUMBER ERROR 


System does not include a logical dise unit with the number indicated. 
Program, terminates; feasibility condition: NO. 


0713 x SERIAL NUMBER ERROR XXXXXX 


The volume serial number, as punched in card columns 7 to 12, 
does not agree with the serial number actually written on the volume. 
Program terminates; feasibility condition: NO. 
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0714 x PERSISTENT ERROR CYLINDER YY 


Persistent error in writing headings on cylinder number YY. 
Program terminates; feasibility condition: NO. 


0715 x NOT EXECUTABLE COLUMN NN 


The area beginning with columns NN cannot be executed. (e.g. a 
file increase was requested but the available area is not great 
enough to contain it), 

Program terminates; feasibility condition: NO. 


0716 x FILE UNKNOWN 


Volume indicated does not contain a file with the name punched 
in columns 14 to 25 of the FLU or FLD cards, 
Program terminates; feasibility condition: NO. 


0717 « OVERFLOW FILE LABEL 


No further file labels can be written on sectors 00002 to 00017 
of cylinder zero. 
Program terminates; feasibility condition: NO. 


0718 x OVERFLOW AVAILABLE CYLINDERS TABLE 


Overflow beginning with segment 00019 containing the free area 
table. Indicates the maximum limit or more then 24 areas have 
been created. 

Program terminates; feasibility condition: NO. 


0719 x NOT EXECUTABLE 


General message indicating that an order cannot be executed. 

The program prints this message when it cannot give more precise 
details as in 0715. 

Program terminates; feasibility condition: NO. 
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EXAMPLE 


Assuming all "data" files are to be deleted from the System Disc, the order 
ecard should have the following format: 


Cot. lto 4 oFLW 
Col. 5 to 80 B..B 


The detail eard following the order card should be punched as follows: 


Col, 1to 4 FLD 
Col, 5to 6 sD 

Col. 7to12 OGE 0001 
Col. 138 x 

Col. 14t080 =... 8 


An END card must follow the detail card, 


Col, lto 4 BEND 
Col, 5 to 80 Blank. 
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@APS ASSEMBLE APS PROGRAM 


1. 


FUNCTION 


This Order calls out the APS Assembly program for translating from 
source to machine language, assembling the subroutine called in turn, if 
any. 


SYSTEM UNITS REQUIRED 


Assemble APS Program requires the following peripherals 


- a Dise unit 
= a printer 
-  acard reader 


PARAMETER CARDS 


This program requires only’ the order card with the following format: 


Col. Lto 4 eAPS 
Col. 5 source program medium: 


3, program is punched on cards codified in Basic APS 
or in APS II 

program is punched on cards codified in Extended 
APS 

program resides on free area of System Disc and 
the SD is the only medium used. This is a typical 
case with TAB IIi and SPG 

program is punched on cards and a free area of the 
work dise is utilized 

program resides on the free area of the SD but a 
work dise is used for the assembly 


e 


NY 


2 


= 


oO 


Col. 6 


Col. Tto14 
Col. 15 to 49 


Col, 50 to 72 
Col. 73 to 76 
Col. 77 to 80 
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source program: 

B, tf it is a program 

1, if it is a subroutine 

2, if it is an EIOS subroutine (Discs) 
name of program or subroutine 


program description printed as the heading of the object 
program listing 


not used 
optional ID code 


not used, 


CHECKS AND ERROR MESSAGES 


For error controls and consequent messages see APS manual. 
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eCOB COMPILE COBOL PROGRAM 


1. FUNCTION 


This Order calls COBOL Compiler for translating a program from source 
to machine language. 


2. SYSTEM UNITS REQUIRED 


This program, with a minimum of 12 K store, requires the following 
peripherals: 


- acard reader 
- aprinter 


- a Dise unit for the SD which must have 48 free cylinders. 


38. PARAMETER CARDS 


This program requires only the order card whose contents are the 
following: 


Col. Lto 4 eCOB 

Col. 5to 8 Not used 

Col. 9 D 

Col. 10 L, program listing is to be output 
%, program listing ig not to be output 

Col. 11 f, the source program is to be compiled from cards 
D,the source program is to be compiled from disc 

Col. 12 Not used 
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Col. 


Col. 
Col. 
Col. 


Col. 
Col. 


Col. 
Col, 


13 to 20 


21 to 25 
26 to 37 
38 to 39 


40 to 71 
72 


73 to 76 
77 to 80 
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if D in column 11, the name of the program to be compiled, 
otherwise not used 

Object program decimal start address (optional) 

Not used 

DM, "Debug Mode" is requested. 

}4, ‘Debug Mode' is not requested 

Not used 

K, if source program ig on card. 

Number of the Dise unit on which the source program is 
stored. 

Optional ID code 

Not used 


CHECKS AND ERROR MESSAGES 


For error controls and consequent messages see COBOL Reference 
Manual. 
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COMPILE FORTRAN PROGRAM 


This Order calls FORTRAN Compiler for Translating a program from 
source to machine language. 


2. SYSTEM UNITS REQUIRED 


This program, with a minimum of 12 K store, requires the following 


peri 


‘ipherals: 


a card reader 
@ printer 
a Disc unit 


3. PARAMETER CARDS 


3.1. 


Col. 
Col. 
Col. 


Col 


Col, 


Col. 


ORDER CARD 


ito 4 
Sto 8 
9 
. 10 


11 


12 


eFOR 

Not used 

D 

Kind of medium containing the source program: 
D= disc 

Ks, or any character = cards 

Option for the printout of the object program 

L = program listing is to be output 

bb = program listing is not to be output 

W, if a Work Disc is assigned in addition to the System 
Dise 

B, if only the System Dise is used 
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Col. 13 


Col. 14 


Col. 15 
P Col. 16 
Col. 17 


Col. 18 to 20 


Oo Col. 21 to 25 


Col. 26 to 33 
Col. 34 to 72 
Col. 73 to 76 
Col. 77 to 80 


oO 3.2. END CARD 
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Memory size used when compiling the program 


3 =12K store 
4=16 K store 


Memory size used when executing the program 


3 =12K store 
4=16K store 


B, if the object program does not use tapes 

1, if the object program uses tapes 

}, if the object progran does not use discs 

1, ifthe object program uses discs 

%, if the object program does not use the card punch 
1, if the object program uses the card punch 


Start address decimal of the object program; blank if the 
start address is 1800 

program name 

Not used 

Optional ID code 

Not used 


The source program (if punched on cards) is to be placed following eFOR 
card, In this the end of source program is signalled by END card with the 


following format: 


Col. lto 4 
Col. 5to 80 


‘END 
not used 


4, CHECKS AND ERROR MESSAGES 


For error controls and consequent messages, see FORTRAN Language 


manual. 
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esct GENERATE SORT/MERGE FOR TAPE 


1, FUNCTION 


This Order calls SGT compiler which provides to generate a Sort or Merge 
program for tape in APS language; this program is translated into basic 
language by means of the APS compiler. Q 


2, SYSTEM UNITS REQUIRED 
This Order requires the following peripherals 
- acard reader *) 


- aprinter 
- adise unit 


3, PARAMETER CARDS 


This Order Requires only the order card whose contents are the oO 
following: (+) 
Col. Lto 4 eSGT 
Col. 5to 8 Not used 
Col. Ttol4 name of the program which ts compiled 
Col. 15 to 49 program description, which is printed as header of 
the program listing 
Col. 50 to 72 Not used 
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Col. 73 to 76 Optional ID code 
Col. 77 to 80 Not used 


CHECKS AND ERROR MESSAGES 


For error controls and consequent messages see the manual Sort Generator 
for Tape. 
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@SPG GENERATE SORT/MERGE PROGRAM 


1. FUNCTION 


This Order calls SPG compiler which provides to generate a Sort or Merge 
program in APS language; this program is translated into basic language 
by means of the APS compiler. 


2. SYSTEM UNITS REQUIRED 


This Order requires the following peripherals: 
- acard reader 

- aprinter 

- a Disc unit 


3. PARAMETER CARDS 


This Order requires only the order card whose contents are the following: 


Col. Lto 4 eSPG 

Col. Sto 8 Not used 

Col. Tto14 name of the program which is compiled 

Col. 15 to 49 program description, which is printed as header of the 
program list 

Col. 50 to 72 Not used 

Col. 73 to 76 Optional ID code 

Col. 77 to 80 Not used 
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4, CHECKS AND ERROR MESSAGES 


For error controls and consequent messages see the manual Sort Program 
Generator. 


93 


DISC OPERATING SYSTEM 


eTAB TRANSLATE TAB PROGRAM 


1, FUNCTION 


This Order calls TAB compiler which provides to translating a program 
written in TAB language into APS; this program is then translated by 
mean of APS compiler. 


2, SYSTEM UNITS REQUIRED 


This Order requires the following peripherals: 
- acard reader 
- aprinter 


-  dise unit 


3. PARAMETER CARDS 


3.1. ORDER CARD 


Col. Lto 4 eTAB 
Col. 5 }, if a Work Disc is assigned in addition to the System 
Disc. 


1, if only the System Disc is used. 
2, if only TAB compilation is desired. 


Col. 6 J, if the source program is written in TAB IIL 
1, if the source program is written in TABI or TAB TL 
Col. 7to14 program name; first four characters must be equal to 
the program code punched in the first four columns of the 
source deck. 
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Col. 15 to 34 program description, which is printed as header of the 
program list. 

Col, 35 to 72 Not used, 

Col. 73 to 16 Optional ED code 

Col. 77 to 80 Not used. 


3.2. END CARD 


After eTAB card must be placed source program cards whose end is 
signalled by END card: 


Col. lto 4 ‘END 
Col. 5 to 80 Not used. 


4, CHECKS AND ERROR MESSAGES 


For error controls and consequent messages see the manuals relative to the 
TAB language. 
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eAPI ASSEMBLED PROGRAM INSERT 


2. 


FUNCTION 


To insert an object program, generated in the work area of a compiler, 
into the program file of the system disc. This is the first and largest 
area indicated in the free area table of the SD. 


To insert a new program, the file must be reorganized: all type 3 programs 
generated for controlled execution are deleted and the new program is 


inserted in the file following those remaining. 


Following the program are printed the volume label, the program file 
update label and the message: 


DISC LABEL AND FILE LABEL 
It should be noted that only one program is to be written at a time and 


that the order eAPI must come immediately after the compilation order 
eAPS, 


SYSTEM UNITS REQUIRED 
The following peripherals are needed: 


-  adisc unit on which the System Dise is mounted 


- a printer. 
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PARAMETER CARDS 


The Assembled Program Insert used only the order card with the following 
format: 

Col, lto 4 Order identification code: eAPI 

Col. § Program Type 

Col. 6 to 13 Program Name 

Col. 73 to 80 Serial code (if desired) 


DESCRIPTION AND EXECUTION 


The Assembled Program Insert is made up of a single segment located 
at address 2048 (decimal). 


The object program is inserted in the work area in the 6-bit mode and 
organized in pages having a maximum of 512 characters in unpacked form. 
eAPI writes the program in the program file in 8-bit mode and organizes 
it in pages having a maximum size of 1024 characters. 


CHECKS AND ERROR MESSAGES 


Checks carried out by the program on peripheral units and to determine 
the physical precision of the order card, may give rise to the following 
error messages: 


1001 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying logical disc 
unit N. 
Program terminates, feasibility condition: NO. 
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1002% D. UNIT N OUT OF ORDER 


Unit N signalled out of order. The program causes the printer 
to move the paper to a new page and halts at location 01DA; 
pressing RUN retries the operation that caused the Signal. If 
the signal repeats, the program terminates and the feasibility 
condition is: NO. 


1003 x D. UNIT N PERSISTENT ERROR 


Persistent positioning error on unit N. The program terminates; 
feasibility condition: NO. 


1010 # MULTIPLE PROGRAM NAME 


A program with the game name as the one being inserted exists 
on the program file. 
The new program is still inserted and the old program must be 
deleted by means of an order eSDS, if the new program is to 

. replace the old one. 
At the end of the program, the feasibility condition is: NO. 


1011 x OVERFLOW OF PROGRAM FILE TN...N LAST PROGRAM 


The program file has surpassed the maximum dimension after 
writing a new program, File writing terminates, the last fully 
written program NN is a type T program. The program terminates; 
feasibility condition: NO. 


1012 PROGRAM CODE ERROR 


Wrong code for the type of program to be written; column 5 of the 
order card does not contain a 1 or a 3. 
Program terminates; feasibility condition: NO. 


1013 x PROGRAM NOT AVAILABLE 


The program written in the compiler working area .is not the 
one indicated on eAPI order card. 
Program terminates; feasibility condition: NO. 
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1014 x OVERFLOW OF PROGRAM TABLE 
The program file index has reached the maximum size of 259 
programs so that no other records can be written. 
Program terminates; feasibility condition: NO. 

1098 x PROGRAM FILE NOT AVAILABLE 
As a consequence of the last error printed, the program file is 
no langer usable. 


EXAMPLE 


To insert a type 3 program named CANE, which has just been compiled at the 
end of the System Dise program file, the order card should be punched as 
follows: 


Col. lto4 eAPI 
Col. 5 3 
Col. 6to9 CANE 


Col. 10t080 6... 6B 
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ePRL PROGRAM LOAD 


1. FUNCTION 


To seek a type 3 program on the System Disc, Library Dise or Master 
Dise, load it and start it. 


2, SYSTEM UNITS REQUIRED 


The Program Load uses the following peripherals: 


~ adise unit for the SD, LD or MD 
-  acard reader for detail card input 


- a printer. 


3. PARAMETER CARD 


The program uses an order card as the parameter card plus LBC cards 
(see Appendix A), followed by an END ecard. 


The order card has the following format: 


Col. 1lto 4 Identification code: ePRL 
Col. 5 to 12 Name of the program to be started. 


Col. 13 C - if the program to be started is to be carried 
out in controlled form (using order eDPG). 
Otherwise left blank. 


100 


Cot, 


Col. 
Col. 


Col. 
Col, 
Col. 


14 


15 and 16 
17 


18 to 49 
50 to 72 
73 to 80 
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P ~ if the program is to be carried out using a trace 
routine, i.e. with printing of the jump instructions 
given, 

Otherwise left blank. 


Not used. 


Code explaining how data contained in columns 18 to 
49 of the order card is to be used: 


x if the contents are to be moved into the user area. 
Blank otherwise. 


Data to be moved into the user area (optional), 
Not used. 


Serial code, if any. 


The END card and ePRL card must %e present even if there are no LBC 


cards, 


DESCRIPTION AND EXECUTION 


The program is on the System Dise and is made up of 4 segments located 
respectively at memory addresses: 5024, 7872, 11 968, 16 064 (decimal), 
The 2nd, 3rd, and 4th segments contain the trace routine for 8K, 12K, 
16K memories respectively. 


The first segment searches for the check point file which has the label 
CHKP followed by the name of the program to be started. If not found, it 
searches the general CHKP file. If found, the initial address of the file 
(first sector of the first cylinder containing the file) is read into memory. 
For a negative search, the value 00000 is stored (decimal). 


In addition the program makes sure that the check point size is twice the 
memory size, 
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After this, the program index is read and the requested program is 
retrieved, 

If the program uses a file table, LBC cards are read and the file table 
is updated, the memory locations that are not used by the program are 
filled with characters 0A and the first segment is read into the memory 
and started. 


If the trace routine is requested, a decision is made according to whether 
or not the available memory can accommodate the trace routine segment 
corresponding to the memory size that is being used. The ePRL program 
generated by the order #MDG and inserted in the MD also Functions as a 
Monitor. Indeed the Monitor provides all the Functions of the ePRL 
program once it is started by the appropriate order card. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of the units and the validity of parameters 
punched in the order card. 


Any error causes one of the following messages to appear: 


1401 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading logical dise unit N containing program file. 
The program stops; feasibility condition: NO. 

1402» D. UNIT N OUT OF ORDER 


Logical disc unit N containing the program file is out of order. The 
program slews the paper to the next page and halts at location 01DA. 
Pressing RUN retries the operation; if the message is repeated the 
program stops; feasibility condition: NO. 


1403 x» D. UNIT N PERSISTENT ERROR 


Persistent positioning error on logical dise unit N containing the 
program file. The program stops; feasibility condition: NO. 
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Col. 


Col. 
Col, 


Col. 
Col. 
Col, 


14 


15 and 16 
17 


18 to 49 
50 to 72 
73 to 80 
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P - if the program is to be carried out using a trace 
routine, i.e. with printing of the jump instructions 
given. 

Otherwise left blank. 


Not used, 


Code explaining how data contained in columns 18 to 
49 of the order card is to be used: 


x if the contents are to be moved into the user area. 
Blank otherwise. 

Data to be moved into the user area (optional). 

Not used. 


Serial code, if any. 


The END card and ePRL card must be present even if there are no LBC 


ecards. 


DESCRIPTION AND EXECUTION 


The program is on the System Disc and is made up of 4 segments located 
respectively at memory addresses: 5024, 7872, 11 968, 16 064 (decimal). 
The 2nd, 3rd, and 4th segments contain the trace routine for 8K, 12K, 
16K memories respectively. 


The first segment searches for the check point file which has the label 
CHKP followed by the name of the program to be started. If not found, it 
searches the general CHKP file. If found, the initial address of the file 
(first sector of the first cylinder containing the file) is read into memory. 
For a negative search, the value 90000 is stored (decimal). 


In addition the program makes sure that the check point size is twice the 
memory size. 
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After this, the program index is read and the requested program is 
retrieved. 

If the program uses a file table, LBC cards are read and the file table 
is updated, the memory locations that are not used by the program are 
filled with characters 0A and the first segment is read into the memory 
and started. 


If the trace routine is requested, a decision is made according to whether 
or not the available memory can accommodate the trace routine segment 
corresponding to the memory size that is being used. The ePRL program 
generated by the order eMDG and inserted in the MD also Functions as a 
Monitor. Indeed the Monitor provides all the Functions of the ePRL 
program once it ig started by the appropriate order card. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of the units and the validity of parameters 
punched in the order card. 


Any error causes one of the following messages to appear: 


1401 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading logical disc unit N containing program file. 
The program stops; feasibility condition: NO. 

1402 x D. UNIT N OUT OF ORDER 


Logical disc unit N containing the program file is out of order. The 
program slews the paper to the next page and halts at location 01DA. 
Pressing RUN retries the operation; if the message is repeated the 
program stops; feasibility condition: NO. 


1403 x D, UNIT N PERSISTENT ERROR 


Persistent positioning error on logical disc unit N containing the 
program file. The program stops; feasibility condition: NO. 
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1410 x PROGRAM NOT FOUND 


The requested program has not been found in the program file. 
The program stops; feasibility condition: NO. 


1411 x SUB ORDER CARD ERROR 
The detail card read cannot be identified. The program stops; 
feasibility condition: NO. 

1412 x SUB ORDER CARD COLUMN NN ERROR 
Detail card area starting from column NN incorrect. The program 
stops; feasibility condition: NO. 

1413 x EXECUTION WITH PATH DUMP NOT POSSIBLE 


No available area in the memory to load the trace routine as 
requested, 
The program is started nonetheless; feasibility condition: YES. 


1414 * FILES-TABLE ADDRESS ERROR 


The start address of a program containing the files-table, is greater 
than OFAO, and it is not possible updating the files-table. Program 
execution stops. Feasibility condition:NO. 


1415 x ORDER CARD COLUMN NN ERROR 
. Card ePRL area starting from column NN incorrect. 
The program stops; feasibility condition: NO. 
1416 x CHECK POINT FILE TOO SMALL 


The volume area reserved for the check point file is not of sufficient 
lenght. This message also appears when the program does not provide 
for the use of this file. The program stops; feasibility condition: NO. 
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EXAMPLE 


To load and start a program with the code 5002 that has been generated by 
the order #DPG on a card with the serial code 0003, the order card 
should be punched as follows: 

Col. 1lto 4 @PRL 

Col. 5 to 12 5002 

Col, 13 c 

Col. 14 to 16 BB... B 

Col. 17 to 72 Not used 

Col. 73 to 80 0003 


This card is followed by the END card: 


Col. Lto 4 ¥END 
Col. 5 to 80 Blank. 
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eAPP ASSEMBLED PROGRAM PUNCH 


1, FUNCTION 


To punch a program that hag just been translated or a program from the SD 
or LD. As the program thus obtained can be used immediately by the eSDU 
and eLPC programs, PLC and SIN cards are also punched. 


2. SYSTEM UNITS REQUIRED 


Assembled Program Punch requires the following peripherals: 


- a dise unit on which the SD or LD is mounted 
- a printer 


-  acard punch 
3. PARAMETER CARD 
Assembled Program Punch requires only the order card with the following 


format: 


Col. 1- 4 Order identification code: eAPP 


Col, § Type of program to be punched (1 or 3) 
Col. 6-13 Program name 
Col. 14 B Ifthe program to be punched is already included in 


the program file 


* If the program has just been translated so that it is 
located in the service area. 
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Col. 15 to 18 Code of the program to be punched in columns 1 to 4 
of the program card. 


Col. 19 ¥ if column 36 of the PLC card is punched with an I; 
R if column 36 of the PLC card is punched with an R. 


Col. 20 Code specifying if the (decimal) number of cards for 
each program segment is to be punched in columns 
33 - 36 of the SIN and END cards: 
~ any code if punching requested, 
~ otherwise left blank. 

Col, 21 to 72 Not used. 

Col. 73 to 80 Identification code. 


DESCRIPTION AND EXECUTION 


The Assembled Program Punch is made up of a single segment located at 
address 2048 in the memory. It contains the various card punch subroutines 
for the various types of punches; subroutine selection is based on indications 
contained in the DOS area reserved for system configuration. 


The program prints all the cards punched and, if a punching error occurs, 
prints an asterisk (x) opposite the contents of the card involved. The 
punched detail cards PLC, SIN and END will have the date punched as 
B$Y¥YDDD in columns 387 - 42 


CHECKS AND ERROR MESSAGES 


The Assembled Program Punch checks the units and the validity of the 
parameter card; one of the following messages is printed when an error 
is encountered: 
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2101 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading, writing or verifying logical diae N. 
The program stops; feasibility condition: NO. 

2102 x D. UNIT NOUT OF ORDER 


Logical dise N is out of order. The program causes the printer 
to slew to the next page and halts at location OIDA. 

Pressing RUN retries the operation that caused the message. 

If the message repeats, the program stops; feasibility condition: 
NO. 


2103 x D. UNIT N PERSISTENT ERROR 
Persistent positioning error on logical dise N. 
The program stops; feasibility condition: NO. 
2110 x ORDER CARD ERROR 
An error has been found on the order card. 
The program stops; feasibility condition: NO. 
2111 x PROGRAM NOT FOUND 


The requested program cannot be found in the file or the service 
area, The program stops; feasibility condition: NO. 


2112 x PROGRAM NOT AVAILABLE 


The program in the service area is not the same ag the one 
mentioned on the order card. The program stops; feasibility 
condition: NO, 


2113 x PROGRAM NOT AVAILABLE 


The program in the service area is not the same as the one 
mentioned on the order card. The program stops; feasibility 
condition: NO. 
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To punch a program named FASE 1 located in the SD with the identification 
code 4047 the order card should be punched as follows: 


Col, 
Col. 
Col. 
Col, 
Col. 
Col, 
Col. 


lto 4 
5 
6 to 13 
14 
15 to 18 
19 
20 to 80 


oAPP 
3 
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ePCC PUNCHED CARD CHECK 


FUNCTION 


This Order allows to control the object program cards punched with Order 
APP and the object program written on the program file of the SD or on the 
work area, 


SYSTEM UNITS REQUIRED 


This program requires the following peripherals: 


~ acard reader 
- a printer 


- a Disc unit for the SD 


PARAMETER CARDS 


This program uses the order card only, which is followed by the card deck 
punched by the eAPP program. The order card has the following format: 


Col. 1to 4 ePCC 
Col. 5to013 type code and name of the program to be controlled 
Col. 14 }, if the program to be controlled is written on the 


program file of the SD 
*, if the program to be controlled is written on the 
work area 


Col. 15to18 program code punched on the object cards in columns 
T+4 
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Col. 19 to 72 Not used 
Col. 73 to 76 Optional ID cade 
Col. 77 to 80 Not used. 


DESCRIPTION AND EXECUTION 


The program consists of a single segment. First the validity of the order 
card parameters is checked, then if no error occurs the object program 
ecards are read and compared with the dise data. 


If there is any difference, the card in question is printed, preceded by 
two asterisk as well as the corresponding part of the disc. 


CHECKS AND ERROR MESSAGES 


The program makes the following checks: 


- the validity of the codes punched on the order card 


- the presence of the program to be checked on the program file or on 
work area of the SD, as indicated in col. 14 of the order card 


- the validity of cards punched. 
The following messages may be printed: 


2401 * D. UNIT N PERSISTENT ERROR 


Persistent read error on disc unit N. The program halts at 
address 02A6. Feasibility condition: NO, 


2402 * D, UNIT N OUT OF ORDER 


Logical dise unit N out of order. The program causes the printer 
to move the paper to a new page and halts at location 01DA. 
Pressing START retries the operation that caused the signal. 

If the signal repeats, the program terminates; feasibility condition 
NO. 
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2403 * D. UNIT N PERSISTENT ERROR 


Persistent positioning error on logical dise unit N. 
Program stops; feasibility condition: NO. 


2410 * ORDER CARD ERROR 


Wrong parameters on the order card; 
Program execution halts; feasibility condition: NO. 


2411 * PROGRAM NOT FOUND 


The program to be checked is not present either in the program file 
nor in the work area. 
Program execution halts; feasibility condition: NO. 


2412 * NO PUNCHER 


No punch is connected. Program execution halts; feasibility 
condition: NO, 


2413 * PROGRAM NOT AVAILABLE 


The program present in the work area has a name different from 
the one specified in the order card. Program execution halts; fea- 
sibility condition: NO. 


2414 * PUNCH ERROR ON CARD ** 


There is a punch error on the card whose immage printout is 
preceded by two asterisks. 


2499 * END OF PUNCH CARD CHECKING 
End of program. 
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DISC OPERATING SYSTEM 


The object program cards, whose name is FASE#3 and its code is 1509, 
must be checked. This program is punched by oAPP and inserted in the 
program file of the SD. The contents of the order card is the following: 


Col. 
Col. 
Col. 
Col. 
Col. 
Col. 
Col. 


lto 4 
5to13 
14 

15 to18 
19 to 72 
73 to 76 
77 to 80 


PCC 

FASEK3 

Blank 

1509 

Not used 
Optional ID code 


Not used. 
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ePTR PROGRAM TRANSFER 


1, FUNCTION 


This program performs two different functions: 
a) the generation of a type SD program file containing all or part of a 
basic System Dise 
P b) the insertion in a type SD program file of one or more programs 


contained in another System Disc. 


The utilization of these two functions successively allows to generate a new 
System Dise from a basic SD and from another SD containing, in compa- 
rision with the first one, new or updated programs. 


° 2, SYSTEM UNITS REQUIRED. 


This program requires the following peripherals: 
- a dise unit for the System Disc used to initialize the system 


-  adisc unit on which output dise is mounted 


oO - acard reader 
(*) - a printer 


3. PARAMETER CARD 
3.1, ORDER CARD 


Col. 1Lto 4 ePTR 
Col. 5 must contain one of the following characters: 


D, if the program file of the SD must be translated fully 
or partially on the output dise. 
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I, if one or more program of the SD must be inserted 
in the program file on the output disc. 


In the first case the order card can be followed by PRM 
detail cards; in the second case it must be followed by 
PRI detail cards. 


Col. 6to 7 SD or the logical number (col. 7) of the unit containing 
the System Dise. 


Col. 8t013 serial number of the System Disc, if it must be checked; 
otherwise blank 

Col. 14to 15 Logical number of the unit (col. 15) containing the 
output disc 

Col, 16 to 21 Serial number of the output disc, if it must be checked; 
otherwise, blank. 

Col. 22 to 72 Not used 

Col. 73 to 76 Optional ID code 

Col. 77 to 80 Not used. 


3.2. DETAIL CARDS 


3.2.1, - PRM card (Program Remove) to eliminate a program 
Col. 1lto 4 KPRM 
Col, 5 type code of the program specified below 


Col. 6to13 name of the program which must not be transferred from 
the System Disc to the output disc (BASIC SUB, if all 
subroutine library must be eliminated), 


Col. 14 to 80 Not used. 
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3.2.2. - PRI card (Program Insert) to insert a program 


Col. Lto 4 PRI 


Col. 5 type code of the program specified below 
Col. 6 to 13 name of the program which must be transferred from 
the System Dise to the output disc 
Col. 14 to 80 Not used. 
P 3.3. END OF ORDER CARD 
After the detail cards must always be the end-of-order card: 
Col. 1lto 4 KEND 
Col. 5 to 80 Not used 
if incol. 5 of the order card character "D" is punched and an END card 
*) follows immediately,the System Disc is duplicated on the output disc. 


4, DESCRIPTION AND EXECUTION 


The ePTR performs the following operations: 


Ce) - check of the parameters of the order card 
f+) - check of the serial number of the input and output volumes, if 
requested 


- search of the program file label of the SD and OD, storing useful 
informations and checking whether both files are type SD or not, 


-  analisys of the character punched in col. 5 of the order card 
a) if the character D is present: 


- reading of the program index of the System Dise 
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- update and shift of the index according to the informations 
contained in PRM cards, if there are. 
So that the index of the programs, which must be transferred 
on the output disc, is generated in core store, The detail 
cards are read and checked formally, When the end of order 
card is detected, the index is written on the output disc 


- if the subroutine library must not be eliminated, the index 
of the library is transferred on the output dise 


- transfer on the OD of the program whose name is written in 
the index 


- transfer of the subroutine, if requested. 


- Update of the areas limitation on the file label of the OD 
b) if the character I is present: 
- reading of the PRI detait card 


After checking the formal validity of the detail card, a table, containing 
the names of the programs which must he inserted on the OD, is built. 


- If the insertion on the subroutine library is requested the index is 
written on the OD and the programs are shifted by a number of cylinders 
sufficient to contain the subroutines being inserted. 


If the available area is not sufficient the insertion of the library is not 
done. 


- Recording of the subroutine, if requested. 


- Update of the areas limitation on the file label of the OD. 
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CHECKS AND ERROR MESSAGES 


The following messages may be printed: 


7101 * D, UNIT N PERSISTENT ERROR 


Persistent reading or writing error on disc unit N. The program 
halts at address 02A2. Feasibility condition: NO. 


7102 * D, UNIT N OUT OF ORDER 


Logical disc unit N out of order. The program causes the printer 
to move the paper to a new page and halts at location OLDA. 
Pressing START retries the operation that caused the signal. 
If the signal repeats, the program terminates; feasibility condition: 
NO. 

7103 * D. UNIT N PERSISTENT ERROR 
Persistent positioning error on disc unit N. Program stops at 
location 02A2; feasibility condition: NO, 

7104 * D. UNIT NIS NOT A "SD" 


No System Disc is present on disc number anit N, 


7105 * 2BASICSUB MERGING IMPOSSIBLE 
The insertion of the subroutine library is impossible because the 
available area on the output disc is not sufficient. 
7110 * MULTIPLE PROGRAM NAME TNNNNNNNN 
The insertion of a program already existing on the output disc 
is requested. 
7111 * OVERFLOW OF PROGRAM FILE/TNNNNNNNN LAST PROGRAM 


The free area on the output disc is not sufficient to contain all 
the programs being inserted. The last program inserted is 
TNNNNNNNN. 
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7114 * OVERFLOW OF PROGRAM TABLE/TNNNNNNNN LAST PROGRAM 
The number of the programs contained in the output disc index 
has reached the maximum allowed (259). 

7119 * DETAIL CARD OVERFLOW/PRI TNNNNNNNN LAST CARD 


There are more than 259 PRI detail cards. The last card printed 
is the last card accepted by the system; these following it are 
ignored. 


7141 * DATA CARDS WRONG 
This message preceds the listing of eventual PRI detail cards not 
processed due to one of the following reason: 
- the program to be inserted is not present in the input disc. 


- the area reserved in output is not sufficient to contain the file. 


7161 * DISC UNIT N NUMBER WRONG 
The same logieal number has been assigned to for two dise unit. 
Program execution stops at location 02A2; feasibility condition:NO, 

7162 * UNIT N SERIAL NUMBER WRONG/SHOULD BE YYYYYY 
Serial number of the volume mounted in logical unit number N is 
different from which specified in the order card. Program 
execution stops at location 02A2. 

7163 * LABEL OF PROGRAM FILE NOT FOUND 
The label of the program file has not been found in the output 
disc. Program execution stops at location 02A2. 

1164 * EXECUTION TYPE CODE ERROR 


An incorrect code is punched in column 5 of the order card. 
Program execution stops at location 02A2. 
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7165 * INVALID DETAIL CARD 


The detail card just read has a wrong identification cade (col. 1 
to 4) or the program type specified is incorrect (col. 5). 
This message is followed by the printout of the detail card. 
Program execution stops at location 02A2 if the identification 
code is wrong, otherwise it proceedes and the card contents 
are ignored. 

7166 * SUBROUTINES NOT FOUND 
The insertion of the subroutine library has been requested but 
this does not exist in the input disc. 

7167 * PROGRAM TNNNNNNNN NOT FOUND 


The program being inserted is not present in the input dise. 
7168 * PROGRAM INDEX WRONG UN. X 


The program index of the disc mounted on unit X is wrong. Program 
execution halts at location 02A2. 
7169 * SUBROUTINES INDEX WRONG 
The library index in the input disc is wrong. 
The insertion or recording of the library is not done, 
7180 * SYSTEM DISC TRANSFER 
This message is printed at the beginning of the execution within 
one of the following specifications: 
- REMOVE: if the recording of the program file with the 
elimination of some program is requested 


- INSERT : if the insertion of one or more programs on the 
output dise is requested. 
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7198 * OUTPUT DISC INDEX 


These message precedes the listing of the programs present on the 
output disc at end of job. 


7199 * END OF SYSTEM DISC TRANSFER 


End of program. 


120 


DISC OPERATING SYSTEM 


oPCK PROGRAM CHECKING 


1. FUNCTION 


Checking of the System Disc, obtained with the order ePTR, by means 
comparing new SD with basic SD, 


2. SYSTEM UNITS REQUIRED 


This order requires the following peripherals: 
- acard reader 

- a printer 

-  adisc unit for the basic System Disc 


- adise unit for the System Disc on which new updated program have 
been recorded. 


3. PARAMETER CARDS 


3.1. ORDER CARD 


Col. lto 4 ePCK 
Col. § must contain one of the following characters: 


D, if the program file of the SD must be transcribed 
fully or partialy on the output disc. 


I, if one or more program of the SD must be inserted 
in the program file on the output disc. 


In the first case the order card can be followed by PRM 
detail cards; in the second case it must be followed by 
PRI detail cards. 
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1°) 


Col. 6to7 SD or the logical number (col. 7) of the unit containing 
the System Disc. 


Col. 8t013 serial number of the System Disc, if it must be checked; 
otherwise, blank. 

Col. 14 to 15 Logical number of the unit (col. 15) containing the output | 
disc. 

Col. 16 to 21 Serial number of the output disc, if it must be checked; 


otherwise, blank. 


Col. 22 to 72 Not used. can 


Col. 73 to 76 Optional ID code. 
Col. 77 to 80 Not used. 


3.2. DETAIL CARDS 


To check the System Dise generated by means of order ePTR, after ePCK *) 
card must be inserted the same detail cards used for ePTR order. 


8.2.1. - PRM card (Program Remove) to eliminate a program 


Col. lto 4 ‘PRM 

Col. 5 type code of the program specified below. 

Col. 6 to 13 Name of the program which must not be transferred *) 
from the System Disc to the output dise (BASIC SUB, ie) 


if all subroutine library must be eliminated). 
Col. 14 to 80 Not used. 


122 *) 


DISC OPERATING SYSTEM 


3.2.2. ~ PRI card (Program Insert) to insert a program 


Col, lto 4 PRI 


Col. 5 type code of the program specified below 
Col. 61013 name of the program which must be transferred from 
the System Disc to the output disc. 
Col. 14 to 80 Not used, 
P 3.3. END OF ORDER CARD 
After the detail cards must always be the end-of-order card: 
Col. lto 4 KEND 
Col. 5 to 80 Not used 


If incol. 5 of the order card character "D"' is punched and an END card 
re) follows immediately, the System Disc is duplicated on the output disc. 


4. DESCRIPTION AND EXECUTION 
The ePCK order performs the following operations: 
- Checking of the parameters of the order card; the logical unit number 
*) of the output disc must not be equal to the one of the System Disc. 
- Checking of the serial number of the input and output disc, if requested. 


~- Search of the program file label of the basic System Disc and the updated 
System Disc, if requested, storing useful informations. 


- Storing of the index of type 1 and 3 programs present in the updated 
System Disc, if a 12 K core store. 


- Checking of the character punched in col. 5 of the order card: 


1) if the character D is present: all detail cards, which must be PRM 
cards, are read and printed. After checking their validity a check is 


oO 123 


DISC OPERATING SYSTEM 


made to see if the programs that was be eliminated still appear in the 
program index on the updated System Disc. Then all the program 
recorded on the new System Dise are compared with those in the 
basic SD, The subroutine library is processed as the other programs. 
If END card follows the order card all programs of the new SD are 
checked. 


2) if the character I is present: a detail card, which must be a PRI 
eard, is read and printed; the program in it specified is searched 
in the updated SD and compared with that in the basic SD. 


5. CHECKS AND ERROR MESSAGES 
The following messages may be printed: 


7001 * D. UNIT N PERSISTENT ERROR 
Persistent reading error on dise unit N. The program execution 
haits at address 02A2. Feasibility condition: NO. 

7002 * D. UNIT N OUT OF ORDER 


Logical dise unit N out of order. The program causes the printer 
to move the paper to a new page and halts at location 01DA. 
Pressing START retries the operation that caused the signal. If the 
signal repeats the program halts at location 02A2; feasibility 
condition: NO, 


7003 * D. UNIT N PERSISTENT ERROR 


Persistent positioning error on dise unit N, Program execution 
stops at location 02A2. Feasibility condition: NO. 


7061 * DISC UNIT N NUMBER WRONG 


The same logical number has been assigned for two disc unit. 
Program execution stops at location 02A2; feasibility condition:NO. 
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7062 * UNIT N SERIAL NUMBER WRONG/SHOULD BE YYYYYY 
Serial number of the volume mounted on logical unit number N is 
different from which specified in the order card. Program 
execution stops at location 02A2. 

7063 * LABEL OF PROGRAM FILE NOT FOUND 
The label of the program file has not been found. Program 
execution stops at location 02A2. 

7064 * EXECUTION TYPE CODE ERROR 
An incorrect code is punched in column 5 of the order card. 
Program execution stops at location 0242. 

7065 * INVALID DETAIL CARD 
Detail card wrong; the program ignores the card, which is printed, 
and proceeds normally. 

7066 * PROGRAM TNNNNNNNN NOT ERASED 
The program TNNNNNNNN has not been eliminated. This program 
is also checked, 

7067 * PROGRAM TNNNNNNNN NOT FOUND 
The Program labels are not equal; the program TNNNNNNNN is not 
present on one of the two discs. 

7068 * INDEX WRONG 
Program or subroutine index wrong. Program execution halts at 
tocation 0242. 

7069 * LENGTH OF PROGRAM TNNNNNNNN WRONG 


‘The length of program TNNNNNNNN on the basic SD is not equal 
to the length of the same program on the updated SD. 
The program proceeds and checks the following program. 
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oO 


7070 * PAGE DATA WRONG 
A page of the updated SD is invalid; program proceeds normally. 


7071 * PROGRAM TNNNNNNNN NOT INSERTED 


The program TNNNNNNNN has not been inserted. The program 
proceeds normally. 


7072 * SUBROUTINE YNNNNN NOT FOUND/ SHOULD BE YZZZ2Z 
The subroutine YNNNNN is not present on the basic SD, instead 
the subroutine YZZZZZ is located in its place. The program an 
proceeds comparing the subroutine index. 

7073 * LENGTH OF SUBROUTINE YNNNNN WRONG 
The length of the subroutine on the output disc is invalid. The 
program proceeds comparing subroutine index. 

7080 * SYSTEM DISC CHECKING Oo 
This message is printed at the beginning of the execution whitin 


one of the following specifications: 


REMOVE: if the recording of the program file, with the elimination 
of some program, is checked 


INSERT: if the insertion of one or more programs is checked. oO 


7085 * SUBROUTINE CHECKING (2) 
This message is printed at the beginning of the subroutine checking 


7086 * INDEX SUBROUTINE CHECKING 


This message is printed at the beginning of the index subroutine 
checking. 


7099 * END OF SYSTEM DISC CHECKING 
End of program. 
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eGAF SOURCE PROGRAM FILE GENERATE 


FUNCTION. 


This program involves the organization and centralized operational control 
of a computer center's source programs in APS, COBOL and FORTRAN 
language, by releasing the utilization and modification of a program from 
the card deck making it up. 


As to source programs organization, eGAF allows setting up a program 
library on magnetic tape, utilizing the load function of this Order program. 


The file thus obtained is organized in 4005-character numbered blocks, 

each one of which is made up of 80 characters fixed-length logic records. 
Each logic record contains one source card's information, and that 
correspondence is shown hereafter by using the name card-record (or more 
simply "record"). 


The same block can contain card-records of different programs, and the 
passage from one program to another can be told from the diversity of two 
successive card-records' identification codes, for APS or COBOL suurces, 
or from one particular record for FORTRAN sources (this last will be 
described in the section concerning FORTRAN program loading). 


Regarding the operational control of an already-existing sources library, 
oGAF allows insertion of new programs in the file, elimination of already 
existing programs, updating of programs through elimination, substitution 
and insertion of card-records, output of programs on the printer and card 
punch, on the printer only, or on magnetic tape. This last function is 
provided to permit compiling an in-library program, 

For this reason, the output tape is organized in numbered unblocked records 
with 85 characters. Thus the file clearly must be made up of only one 
program's card-records. 
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Utilized both for the creation and operational control of the sources 

library is an input tape containing the library (made up, for the first time, 

of header and trailer labels). Obtained in output are two tapes, one containing 
the created or modified library, the other containing,if required, a program 
extracted for compiling. 


Owing to the difference between organization of FORTRAN cards in respect 
to APS and COBOL cards, the FORTRAN sources cannot coexist on the 
same tape with programs coded in COBOL and APS, 

eGAF can thus organize and contro! either a FORTRAN library or an APS/ 
COBOL library. 


SYSTEM UNITS REQUIRED 


This order needs a 16K store and the following peripherals: 


a card reader 

- acard punch, if required 

- aprinter 

- a dise unit for the System Disc 


- three magnetic tape units 


tape unit 4 on which the source program library is mounted 
tape unit 5 on which the updated library is to be recorded 


tape unit 1 on which the program being compiled is to be recorded, 
if requested. 


The last unit can be substituted by a disc unit. 
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3. PARAMETER CARDS 


3.1. ORDER CARD 


This card has diverse format, depending upon whether it requests 
extraction of 2 program or updating of the library. 


Source Program File Updating 


Col, 1to 4 eGAF 


Col, Sto 7 - b or any character if the Order concerns an APS/ 
COBOL library. 


- FOR code if the Order concerns a FORTRAN library. 
Col. 8 to 80 Not used. 
Extraction of a program existing in the library: 


Col. Lto 4 eGAF 


Col. Sto 7 - % or any character if the Order concerns an APS/ 
COBOL program 


- FOR code if the Order concerns a program in 
FORTRAN. 


Col. 8tols identification code or name of the program existing in 
the library for which the extraction is requested. 

Col. 16 code which identifies the type of extraction requested. 
It can assume one of the following values: 


-}, if the program is to be recorded on tape unit L 
or on dise unit. 


-L, if the program is to be printed 
- P, if the program is to he punched and printed. 
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Col. 17 to18 


Col, 19 to 24 


Col. 25 to 30 


Col, 3 to 36 


Col. 37 to 80 


ifecol. 16=P 
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code which specifies punched cards' sequencing 
criteria. It can assume one of the following values: 


- 8, if the progressive numbering already existing 
on the library tape (numbering increment 


01) is not to be changed 


- any number corresponding to the requested 


numbering increment 


ifcol. 164 P 
not used, 
if col. 16=P 


number to be assigned to the first punched card, leaving 


col. 19 blank for APS programs, 


K, if the numbering must begin from zero. 


if col. 16 4 P, not used. 


if col. 16 =P 


number of the first record to be punched, leaving blank 


col, 25 for APS programs. 


K, if punching must begin from the first card. 


if col. 16 # P not used. 


if col, 16=P 


number of the last record to be punched, leaving blank 


col. 81 for APS programs. 


}, if punching is needed up to the last card 


if col. 16 # P not used. 


not used. 
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3.2, DETAIL CARDS 


These cards follow the order card only when updating the source program 
library. 


3.2.1, - Program load card: serves to load a new program in the library. 


col, 1 Operation code: N 

Col. 2to 9 Identification code or name of the program not existing 
in the library and which is to be loaded on the library. 

Col. 10 not used. 

Col. 11 to 13 can assume one of the following values: 


- COB, if the program to be loaded is coded in 
COBOL. 


- 4, or any character if the program to be loaded is 
coded in APS or in FORTRAN. 


Col. 14 to 80 Not used. 


The card of the program to be loaded are to be placed after the Operation 
card, These cards must be followed by the card shown below. 


Col. ito 5 five asterisks (*) 
Col. 6 to 80 not used 


Should the program to be loaded be in FORTRAN, the first source card 
must be the eFOR card containing in cols. 26 - 33 the name of the program 
specified in the N card. The name's first four characters are assigned as 
identification code to the card-records written on the output tape. 


Each FORTRAN in-library program is preceded by a record having in 


positions 26 - 33 the name of the program drawn from the eFOR. This 
record allows distinguishing one source from another. 
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3.2.2, - Program elimination card: serves to eliminate a program from 
the library. 


Col. 1 operation code: C for APS/COBOL programs 
R for FORTRAN programs 


Col, 2to 9 identification code or name of the program existing in the 
library and which is not to be transferred to the updated 
library tape. 


Col. 10 Not used, 


Col. 11 to 13 Can assume one of the following values: 


- COB if the program not to be transferred is coded in 
COBOL 


- § or any character if the program not to be transferred is 
coded in APS or in FORTRAN, 
Col. 14 to 80 Not used. 


An elimination card, followed by a N card having in cols. 2 - 9 the identifi- 
cation code of the eliminated program,produces total substitution of a 
source library program. 


3.2.8, - Program updating card: allows updating of in-library program 
with one or more of the following cards: 
Col. 1 operation code : P 


Col. 2to 9 identification code of the program existing in the library 
and on which an updating operation is to be made. 


Col. 10 can assume one of the following values: 


-1 ifthe whole updated program is to be printed. 
~} if the updated program is not to be printed. 
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Col. 11 to 13 can assume one of the following values: 


- COB if the program be updated is coded in COBOL. 
-} or any character if the program to be updated is 
coded in APS or in FORTRAN. 


Col. 14 to 80 Not used, 


The P card must be followed by detail cards specifying the changes to be 
made on the program. 


Given below for greater clarity are distinct descriptions of the detail cards 
provided, corresponding to the different languages used in the program to 
be updated. 


a) Card record replacement card in an APS program 


Col. 1 updating code: S 

Col. 2to 6 sequence number (page and line) of the record to 
be replaced. 

Col. 7 to 72 replacement APS card 

Col. 73 to 80 identification code of the program specified on the 
P card. 


Substitution of the STRT or END card record is accepted only if 
the substitute card is respectively a STRT or END, 


b) Elimination card of one or more card records in an APS program. 


Col, 1 updating code: E 

Col. 2to 6 sequence number of the first record to be eliminated 

Col. Tto 8 % 

Col, 9to13 sequence number of the last record to be eliminated. 
}s, if only one record is to be eliminated. 

Col. 12 to 72 Not used. 
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Col. 73 to 80 identification code of the program specified on the 
P card 


The elimination of the STRT or END card-records is not accepted, 


Insertion card of one or more cards between two successive card-records 
or after the last record of an APS program. 


Col. 1 updating code: I 

Col. 2to 6 sequence number of the record after which new 
records are to be inserted. 

Col. 7to 72 not used 

Col. 73 to 80 identification code of the program specified on the 
P card. 


NOTE : The APS cards to be inserted, followed by an end ecard with 
an asterisk in column1, are to be placed after the I card, 


Replacement card of a card-record in a COBOL program. 


Col. Lto 6 sequence number (page and line) of the record to 
be replaced. 

Col. 7 to 72 substitute COBOL card 

Col. 73 to 80 identification code of the program specified in the 
P card. 


Elimination card of one or more card-records in a COBOL program. 


Col. 1 updating code: E 
Col. 2to 7 sequence number of the first record to be eliminated. 
Col. 8to13 sequence number of the last record to be eliminated. 
} if only one record is to be eliminated 
Col. 14 to 72 not used 
Col. 73 to 80 identification code of the program specified on the 
P eard. 
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Insertion card of one or more cards between two successive card- 
records or after the last record of a COBOL program. 


col. 1 updating code: I 

Col. 2to 7 sequence number of the record after which new 
records are to be inserted 

Col. 8 to 72 not used 

Col. 73 to 80 identification code of the program specified on the 
P ecard, 


The COBOL cards to be inserted having col. 1 obligatorily blank, are to 
be placed after the I card. The above cards must be followed by a card 
with an asterisk in col. 1. 


Replacement card of a card-record in a FORTRAN program. 


Col. 1 to 72 substitute FORTRAN card 


Col. 73 to 76 first four characters of the name of the program 
specified in the P card 


Col. 77 to 80 sequence number of the record to be replaced. 


Elimination card of one or more card-records in a FORTRAN program. 


Col. 1 updating code: E 

Col. 2to 5 sequence number of the first record to be eliminated. 
Col. 6to 9 sequence number of the last record to be eliminated 
Col. 10 to 72 not used 

Col. 73 to 80 name of the program specified on the P card. 
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Insertion card of one or more cards between two successive card- 
records or after the last record of a FORTRAN program, 


Col. 1 updating code: I 


Col. 2to 5 sequence number of the record after which new records 
are to be inserted 


Col. 6 to 72 not used 
Col. 73 to 80 identification code of the program specified on the P card. 


The FORTRAN cards to be inserted, having col. 77 obligatorily blank, 
are to be placed after the I card. The above cards must be followed 
by a card with an asterisk in col. 1 and an alphanumeric character 

in column 77, 


General observations: The card with the asterisk in col. 1 at the end of 
the cards to be inserted, is not mandatory (@). If this card is missing, 
however, appropriate printed signaling reveals the fact. 


For correct execution of program updating, the relative detail cards 
must be in ascending order in reference to the sequence number of the 
card records to be updated. 


An exception to this rule is the I insertion card which, only if it 
follows a replacement or elimination card, can have as number of the 
record after which the insertion is to be made, that of the replaced 
or eliminated record respectively. 


Regardless of the type of updating executed on a program, this is 
transferred to the output tape assigning to card records a new progressive 
sequence number, 


(e) for APS and COBOL progrars. 


136 


0 


DISC OPERATING SYSTEM 


3.2.4, - Load check card: serves to check if a program was loaded correctly 
in the library, 


Col. 1 operation code: K 

Col. 2to 9 identification code of the program existing in the library 
and on which the check of a previous lead operation is 
to be made 

Col. 10 Not used 

Col. 11 to 13 can assume one of the following values: 


- COB if the program to be checked is coded in COBOL 


-, or any character if the program to be checked is 
coded in APS or in FORTRAN 


Col. 14 to 18 not used, 

The cards of the source program being checked are to be placed after the 
K card, These cards must be followed by an end card with an asterisk in 
col, 1. 


A check is made on cols. 7 - 72 for programs coded in APS and COBOL 
and on cols, 1 - 72 for programs coded in FORTRAN. 


3.2.5. - END-OF-ORDER CARD 


Col. 1 Operation code ;: Z 
Col. Z2to 9 ZZZZZZZ2 
Col. 10 to 80 not used, 


This card is not necessary if the Order card refers to an -extraction of 
an in-library program. Should the card immediately follow eGAF, 
duplication of the sources library is obtained on the tape mounted on unit 5. 


Detail cards must be sequenced according to ascending identification code 


(cols. 2-9). Any sequencing error impedes the execution of the 
requested operation. 
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DESCRIPTION AND EXECUTION 


The program eGAF is made of 7 segments: 

The first defines the input and output files, analyses the order card, and 
in case of library updating, opens the files. It also contains a variety of 
common routines. 

The second updates the APS/COBOL library. 

The third updates the FORTRAN library. 

The fourth retrives an APS/COBOL program. 

The fifth retrives a FORTRAN program. 

The sixth signals the end of reel on tape unit 5 and closes the files. 

The seventh re-opens the file on unit 5, which contains updated programs, 
and lists them with their respective updating date, In order to list these 
source programs, a comment card, with the following configuration, must 
be inserted before the last card of each program: 


a) for APS program 
* (asterisk) in col. 18, followed by comment 


b) for COBOL program 
NOTE incol. 12 to 15, followed by comment, 


ce) for FORTRAN programs 
C in col. 1, followed by comment, 


The eGAF program proceeds in the following way: 

a) ifthe Order card concerns the updating of the sources library, the 
contents of the library mounted on unit 4 are transferred to the tape 
mounted on unit 5, with new programs load (N card), programs 
elimination (C card), updating with or without total printing of the 
updated program (P card), check of a loading effected in a preceding 
job (K card), 


The following operations are successively executed: 


e Defining files in input and output 
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@ Opening of the files 

© Reading, checking and printing of the detail cards, and execution 
(if no error shown)of the function specified in each, This operation 
is repeated until the end-of-order card appears, which causes 
the transfer of any programs remaining in the library to the 
updated library tape. 

@ Eventual end-of-volume signaling for the output file. 

@ Closing of input and output files. 

e Printing of end-of-program message. 

If the Order card concerns extraction of a program from the library . 

mounted on unit 5, the following operations are successively executed: 

@ Defining the files in input and output 

@ Opening of the files 


e Analyzing the type of extraction requested and,if requested, of the 
punch routine based on the type of punch connected to the system. 
Tf no punch is connected, the impossibility of realizing the 
extraction requested is signalled in printing, 


e Finding of the program involved in the extraction 


@ Eventual end-of-volume signaling, if the extraction is on tape 
{which,in this case,is mounted on unit 1) 


@ Closing of the files in input and output 
@ Printing of end-of-program message. 
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CHECKS AND ERROR MESSAGES 


Error messages are not standard.They lack message number and HLT 
addresses are not definite. Message number is replaced by four asterisks. 
**«+* MULTIPLE PROGRAM NAME 


The loading of a program already existing in the library has been 
requested. The loading is not executed and the message for the 
operator is printed. 


xe C/N/P/K CARD: SEQUENCE ERROR IN PROGRAM CODE 


The identification code of the program specified on a detail card is 
out of sequence. 

The requested operation is not executed and, in case of loading, 
updating or check, the message for the operator is printed. 


##4* DETAIL CARD NOT ACCEPTED: N/P/K CARD NOT FOUND 
A card which is not a detail card or which is not preceded by a detail 
eard has been read. The message for the operator is printed. 

#xe% C/P/K CARD: PROGRAM NOT FOUND 


The program specified in cols. 2 - 9 on the detail card is not present 
in the library. The requested operation is not executed and, in case 
of updating or check, the message for the operator is printed. 


#*4% N/P/K CARD NOT ACCEPTED: DETAIL CARD NOT FOUND 
A loading, updating or check card not followed by a detail card has been 
read, 

*+*** PUNCHING IMPOSSIBLE 


The extraction of a program on the punch while no punch is connected. 
to the systems, has been requested. 
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+4 CHECK OF NNNNNNNN PROGRAM O.K. 
The check of the NNNNNNNN program was successful, 


****C HECK OF NNNNNNNN PROGRAM FAILED 


In this case, before signalling, the tape and records causing the 
error are printed, respectively preceded by the words RECORD and 
CARD. Any excess of records over cards or of cards over records 
shows up when one of the two printed records is made up of blanks. 


+#+#4E/I/S CARD: PROGRAM CODE DOES NOT AGREE WITH "P" CARD 
The identification code punched on an E/I/S card does not correspond 
to the code of the P card preceding it. The request is not executed, 


#*%% SEQUENCE ERROR IN E/I/S CARD 
The sequence number pertaining to updating is out of sequence. 
The requested operation is not executed. 
##4% E/1/S CARD: RECORD NOT FOUND ***#* LAST RECORD **** 
The sequence number of the records to be updated finds no corresponding 
number in the records of the in-library program. 
The sequence number of the last record found is signalled. The request 
is not executed and the message for the operator is printed. 
#ek* ASTERISK CARD NOT FOUND 
The cards following an insertion card do not have an end card with 
an asterisk in col. 1 
#4 REPLACED RECORD 
This message precedes the printing of each record replaced ina 
program, 
+#k+* REPLACEMENT 


This signaling precedes the printing of each record replacing. 
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*4%%* REMOVED 
This signaling precedes the printing of each record eliminated from 
a program. 


ak MERGING 


This message precedes the list of records inserted between two succes- 
sive records or after the last record of a program. 


#4 REMOVE DETAIL CARDS UP TO THE FIRST C/N/P/K/Z CARD 


Message for the operator so that he may extract from the deck of 
unread cards those preceding the first detail card not yet considered. 
The program stops on a watt HLT. By depressing the START button, 
the operator can in any case arrange for the program to ignore the 
cards to be extracted until a new detail card appears. 


*a%% FOR CARD NOT FOUND 


The loading of a FORTRAN program not preceded by the eFOR card 
is requested, 

The loading is not executed and the message for the operator is 
printed. 


+++ WRONG E/S CARD 


The elimination of the STRT or END card-record or else its substi- 
tution with a card different from STRT or END respectively, is 
requested. 

The request is not executed. This message concerns only programs 
coded in APS. 


*44% END OF VOLUME ON UN.X 
The taps mounted on the unit X is not sufficient. 


#4 PROGRAM NOT FOUND 
The program to be extracted is not found on the tape mounted on unit 5, 


*x4% END G,A.F. * 
End of program. 
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An APS8/COBOL source program library is to be updated with the 
following operations: check of the program S$, substitution of the 
program H, updating with printing of the program A with elimination. 
of the first ten records, substitution of the eleventh, insertion of a 


record after the twentieth, and updating of the program U with substi- 
tution of the twentieth record. 


The program A and S are coded in COBOL, while the programs H and 
U are coded in APS. 


The following cards must be punched: 
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b) A FORTRAN source program library is to be updated by executing 
the same operations described in the preceding problem. 
The following cards must be punched, 


oe j 
Iw 
FHT 
t 

: Ht ft || lool2loy 
rot 


c) Extraction on tape of program COPIA codified in FORTRAN language. 


Col, 1lto 4 eGAF 
Col. 5to 7 FOR 

Col. 8to15 COPIABHE. 
Col. 16 to 80 blank 
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d) Extraction, on punch and printer of program COPIA, codified in APS or 
in COBOL, with numbering increment 5 
Col, tto 4 eGAP 
Col. Sto 7 blank 
Col. 8to15 COPTABE 


Col. 16 P 
Col. 17 to 18 05 
Col, 19 to 80 blank 
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oLPC LOAD PROGRAM BY CARDS 


1. FUNCTION 


The Load Program by Cards loads and starts a program on punched cards. 
The object program must be the same in make up as required for an eSDU 
program, or generated as a eAPP output program. 


The program to be started, of type 1 or 3, can include several segments to 
be read in the logical sequence in which they are called. 


2. SYSTEM UNITS REQUIRED 


Load Program by Cards requires the following peripherals: 


- a disc unit receiving a SD, LD, or MD 
-  acard reader 


- a printer. 


8. PARAMETER CARDS 


Load Program by Cards requires a eLPC order card and two types of 
detail cards in addition to the LBC cards if required and the END ecard; 2 
PLC card when the object program is initiated and an SIN card at the 
beginning of each segment to be initiated. The cards must be arranged 
in- the following order: 


- LPC order card 


- LEC opening cards if the program to be initiated is to use files on dise 
or tape (these cards must then be followed by an END card). 
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- PLC card 
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- cards of the object program to be loaded; a SIN card must begin 


each segment 


~ END of order card. 


ORDER CARD 


It has the following format: 


Col. 
Col. 
Col, 
Col, 


Col. 


Col. 


Col, 
Col. 
Col. 


1-4 
5-12 
13-14 
15 
16 
17 
18-49 
50 - 72 
73 - 80 


identification code: eLPC 
program name 
not used 


-H when a HLT preceding the execution of the 
program is desired 


- blank otherwise 


~ # if the store is to be filled with characters 0A 
before the program is loaded 


- ® (asterisk) otherwise 


- x if the storing in User's Area of data contained 
in columns 18 - 49 is desired 


~ # otherwise 
user data, (if any) 
not used 


serial code, (if any). 
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3.2. DETAIL CARDS 


The program requires the PLC and SIN detail cards and the END of order 
card. 


3.2.1. PLC detail Card (Program Label Create) 


This card carries out the same functions as the program label. It has 
the following format: 


Col. 1-4 identification code: B PLC 
Col. 5 program type: 

- 1 for DOS program 

- 3 for user program 
Col, 6-13 program name 


Col. 14 indicates the type of input/output routines used 

by the program. Has the following values: 

K - magnetic tape management routine 

1 - disc management routine 

2 ~ both magnetic tape and disc management 
routines 

3 - neither magnetic tape nor disc management 
routine 


Col. 15 - 23 Not used 


Col. 24 ~ 27 file table address for the program (coded 
hexadecimal) 


0000 - if no file table 


Col. 28 - 31 program start address (coded hexadecimal) 
Col. 32 - 35 maximum program address + 1 (coded hexadecimal) 
Col. 36 I code 


Col. 37 - 80 not used, 
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3.2.2. SEN Detail card (Segment insert) 


As it has been said before there must be a SIN card preceding each 


segment, 


The card has the following format: 


Col. 1- 4 

Col. 5 

Col. 6-13 

Col. 14 - 19 
Col. 20 - 21 

Col.22 - 79° 
Col. 80 


identification code: KSIN 
program type: 


- 1 for DOS program 
- 3 tor user program 


program name 
not used 


number of the segment referred to the object program 
cards that follow theSIN card; if it is the first 
segment 01 is- punched in this field. 


not used 


character E for end of segment 


3.2.3. End of Order Card 


The last card in the deck must be the END card. It has the following 


format: 


Col. 1- 4 identification code: KEND 
Col. 5-79 not used if the program to be initiated is a type 


Col. 80 


3 program (i.e. user program) 


if it is a type 1 program (i.e. DOS program) punch 
parameters aa for order card. 


character F for end of program. 
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DESCRIPTION AND EXECUTION 


The eLPC program, made up of two segments is recorded on cylinder 
zero of the volume used as the system source disc. 


The first segment is initiated by Pilot 1 and is located at address 4608 
(decimal). 


The second segment is read by the first one and is stored at address 
5400 (decimal). 


The first segment performs the following functions: 


- reads and stores the LBC cards, if any 
- assigns logical numbers to any tape handlers, connected to the system 


- stores into memory the start address of the disc area which contains 
the general checkpoint file or the special file, if present. Otherwise 
five binary zeros are recorded 


- checks the size of the disc area containing the CHKP file: it must not 
be less than twice the size of the memory area 


- stores into memory the segment load routine from cards, starting at 
address 684 (decimal) 


- stores into memory the PLC card and the SIN card relative to the 
first segme nt 


- when the program to be initiated involves files on disc/tape, it reads 
into memory at the program location address as many object program 
cards as are necessary to make up the file table 


- stores and initiates the second eLPC program segment. 


The second segment performs the following functions: 


- processing of LBC cards, if any stored in memory (See paragraph A5 
in the Appendix). 
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- validation of a HLT instruction prior to the initiation of the program 
when code H punched in column 15 of the order card (HLT is stored 
at the address 01D2) 


- storing into the memory print area the last part of the eLPC program 
which normalizes the memory with the characters 0A, if required by 
code % (blank) punched in column 16 of the order card 


- calling into execution of the segment load routine from cards, 


The segment load routine from cards reads memory the remaining cards 
of the first segment of the program and initiates it. 


CHECKS AND ERROR MESSAGES 


After checks have been performed on the working of the dise unit and the 
validity of the order cards, errors are indicated by means of the following 


messages: 


2001 x 


2002 x 


2003 x 


Persistent error in reading on the dise unit containing the 
system volume. Program stops; feasibility condition: NO. ‘ 


The disc unit containing the system source volume signals 
an "out of order" condition. 

Program makes a page change on printer and halts at the 
address 01DA. 

After RUN has been depressed the program repeats the 
operation which caused the message; if the message 
reappears, the program stops. The feasibility condition is: 
NO. 


Persistent error in positioning on the disc unit containing 


the system source volume. Program stops; feasibility 
condition: NO. 
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2010 x 


2011 x 


2012 x 


2013 x 


2014 ® 


2015 « 


2016% 


2099 x 


DISC OPERATING SYSTEM 


Option incorrectly written in eLPC card. Program stops; 
feasibility condition: NO. 


Detail card with incorrect identification code. Program stops; 
feasibility condition: NO. 


Program name on a detail card does not match the name in 
the other cards, 


’ Program stops; feasibility condition: NO. 


Columns 20 - 21 of the first card SIN contain a segment 
number other than 01, 
Program stops; feasibility condition: NO. 


The size of the area on which the CHECKPOINT file is recorded 
is insufficient. 

This message is also used when the program does not include 
use of such a file, 

The program is loaded and initiated. Feasibility condition:YES. 


Format error detected in processing on LBC card; program 
stops. Feasibility condition: NO. 


An overflow condition is found in the LBC card storage area. 
This area is big enough to contain LBC cards to open as many 
files as can be processed by a program, that is 10. 

Program stops; feasibility condition: NO. 


START OF PROGRAM XXXXXKXX 


This message indicate that control is transferred to the card 
segment load routine which completes loading of the first 
segment and initiates it. 
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EXAMPLE 


It is desired to initiate a type 3 program called LIST1 punched on cards. 
This program is constituted by made up a single segment that uses card 
read and print routines only. The program start and end addresses are 
2048 and 4095 respectively (both decimal) and the number of cards is 100. 
In addition it is desired to normalize the memory with characters 0A 
before the program is read. Program initiation is to be preceded by a 
HLT. 


The following cards must be punched: 
1. Order Card 


Col. 1- 4 eLPC 
Col. 5-12 LIST1 
Col, 13 - 14 not used 
Col. 15 H 

Col. 16 - 80 not used. 


2. PLC Detail Card 
Col, 1- 5 JPLC 


Col. § 3 
Col, 6-13 LIST1 
Col. 14 3 


Col, 15 - 23 not used 
Col. 24 - 27 0000 


Col. 28 - 31 0800 
Col, 32 - 35 1000 
Col. 36 I 

Col, 37-80 Not used. 
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3, Detail Card SIN 


Col. 1- 4 
Col. 5 

Col. 6-10 
Col, 11-15 
Col. 16-19 
Col. 20 - 21 
Col. 23 - 79 
Col. 80 


4, ENDcard 
Col. 1- 4 
Col. 5-79 
Col. 80 


¥SIN 

3 

LISTL 
not used 
0100 

01 

not used 
E 


BEND 
not used 
F 


DISC OPERATING SYSTEM 


The cards must be read in the order indicated above. The object program 
eards must be inserted between the SIN card and the END ecard. 
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eDPG DEBUGGING PROGRAM GENERATE 


To generate, from an existing type 3 program of the system disc, a program 
for controlled execution. Such generation includes insertion of corrections, 
in basic language, and the trace routine, if requested, plus the various-re- 
entry points requested by the user, in addition. 


The type 3 program selected by the user is taken from the program file. 
When the controlled program is generated it is written at the end of the 
program file, i.e. after the other programs that have already been 
processed by the order eDPG; the original program is left unchanged. 
These programs are shown as type C programs, A type C program cannot 
be further treated by the order eDPG, To insert additional corrections in 
a type C program, the original version must always be used. If an earlier 
type C program exists on the System Disc, the new version is inserted at 
the end of the file but does not delete the previous one. In this case, the 
earlier version can be deleted by an order eSDS, 


If a user should so request, an order eDPG can delete all type C programs 
on the System Disc. 


Type C program cannot be transferred to the Library Dise or to the Master 
Dise: its function is limited to the debugging phase is then started by an 
order ePRL (Program Load), with a C punched in column 13 of the order 
card, 


In requesting a certain number of corrections and use of the trace routine 
with its various re-entry points, the user must bear in mind that insertion 
of such requests depends on the memory area left available by the program 
and that, in any case, the eDPG program can only insert a maximum of 

15 trace pointa, 
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The trace routine must take up a memory area outside that of the program 
and be located at an address that is a multiple of 256 with a length of 468 
characters. An index, whose length is variable and depends upon the 
number of re-entry points requested, is inserted at the end of this area. 
{This index, as will be seen, is made up of n records each containing 12 
characters). 


It should be noted that for each re-entry point requested by the user, 2 
statement 4 or 6 characters in length must be provided, This statement 
can be replaced by a return jump to the trace routine. 

It should also be remembered that a return jump to the trace routine 


destroys the contents of memory locations 254 and 255 which previously . 
existed. 


SYSTEM UNITS REQUIRED 


The eDPG program requires the following peripherals: 


~ a disc unit on which the SD is located 
- a printer 


- acard reader to read detail cards. 


PARAMETER CARDS 


ORDER CARD 
The format of the order card is: 


Col. 1to 4 Order identification code: eDPG 


Col. 5to12 Name of the type 3 program to be generated for 
controlled execution. 
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Col, 16 u - Delete all controller execution programs existing 
in the SD. 
¥ - No deletion. 
Col, 14 to 72 Not used, 


Col. 73 to 80 Serial code (if desired). 


DETAIL CARDS 


There are three types of detail cards, depending on whether only 
corrections are to be inserted (CRT), or the trace routine is to be 
inserted. 


3.2.1, CRT Card (Correction) 
The format of the CRT cars is as follows: 


Col, Lto 4 Identification code: CRT 


Col. 5 to 6 Segment number to which the correction refers 
{value in decimals). 


Col. Tto 8 Correction length, in coded hexadecimal form 


Col. 13 to 72 Correction in base language, in coded hexade- 
cimal form 


Col, 73 to 80 Not used. 


3.2.2. DTR Card (Trace routine) 
The DTR card is used to insert the trace routine. 
The format of this card is as follows: 
Col. Ito 4 Identification code: JDTR 


Col. 5to 8 Location address of the trace routine, in coded 
hexadecimal form. 
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This address must be a multiple of 256. 


Col. 9 to 80 Not used. 


3.2.3, TRC Card (trace routine call) 


The DTR card requests insertion of the type C routine of the trace 

routine, whereas, the TRC card indicates where the tracing is to 

occur and what memory area to print. One TRC card is therefore 

needed for each trace routine entry point. Y 


The TRC card has the following format: 


Col. lto 4 Identification code: BTRC 
Col. § to 6 Segment number in which the jump is located. 
Col. 7010 Memory Address of the jump point location, in 
coded hexidecimal form. (e) 


Col. 11 to 14 Initial address of the memory area to be printed 
in coded hexidecimal form. 


Col. 15 to 18 Length of the memory area to be printed, in 
coded hexidecimal form. 
Col. 19 to 80 Not used. oO 


Detail cards are printed during reading; they should be placed in the 
reader in the following order: 

a) CRT cards if ascending segment number order 

b) =DTR card, if any 

c) TRC cards, if any, in ascending segment number order 


d) END card. 


158 


DISC OPERATING SYSTEM 


DESCRIPTION AND EXECUTION 


The eDPG program is made up of three segments at memory location 2048 
{in decimal form). 


It first scans the program file directory for the program called by the 

order card. To do so, it reads column 13 for the SD location address of 

the generated program. Character corrections, or instructions which are 
already part of the segment, or additional corrections are inserted with the 
possibility of being grouped into blocks, at the end of the corresponding 
segment. Then, if requested, the trace routine and the corresponding 

jumps are inserted. After the trace routine has compiled addresses indicated 
in the DTR card, the routine is located, with whatever corrections may be 
applicable, at the end of the first segment, in a 468 character page. Jump 
returns are inserted in the program as though they were corrections, at the 
entry points indicated on cards TRC, plus the eDPG control program; so 

that the latter are as on the CRT cards, they are arranged in segment 
number order. 

At the end of the first segment, therefore, i.e. immediately following the 
trace routine, a jump index is made up of the same number of 12-character 
records (maximum of 15) as there are entry points in the program. A record 
in the index is made up as follows: 


Card 1lto 2 Input address of the trace routine, 

Cards3to 4 Initial address of the memory area to he printed, 
Cards4 to 5 End address of the area to be printed, 

Cards6 to 11 Program instruction including the return jump 


location of the trace routine. 


While a new program is being inserted, the eDPG checks that the file 
is not greater thant the area reserved for it; the label is updated by 
allowing room for corrections, the trace routine and the index, to 
determine the new theoretical memory location of the program. 
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CHARACTERISTICS OF THE TRACE ROUTINE 


Once this routine has been called by the return jump inserted by the eDPG 
program, it scans the jump index and picks out data concerning the memory 
area to be printed. If this scan is without result, such as in the case of 2 
modifation of the index by the program, the trace routine stops at a HLT and, 
when RUN is pressed, sets the feasibility condition to NO. The trace routine 
usually prints the print area first, and it is modified after wards. It then 
prints a line containing the address of the program point as fellows: 


TRCIIII where III1 is the binary value in hexadecimal form. 


Next the memory is printed in the same form as that of the eMDP program. 
At the end, the trace routine returns registers UF/OF and ZE/NZ to their 
initial status, carries out the program instruction which was replaced by a 
jump return and returns to the main program. 


CHECKS AND MESSAGES 


The following messages are transmitted when the peripherals are checked 
and the contents of the parameter cards read: 


1101 % D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying logical dise unit 
N. Program terminates; feasibility condition: NO. 


1102 x D. UNIT N OUT OF ORDER 


Logical dise N out of order. 

The program causes the printer to move the paper 

to a new page and the program halts at location 01DA. Pressing 
RUN retries the operation that caused the signal. 

If the signal repeats, the program terminates; feasibility 
condition: NO. 
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1110 x PROGRAM NOT FOUND 


SD Program file directory does not contain a program with the name 
punched in the eDPG card. 
Program terminates; feasibility condition: NO. 
1111 » XXX CARD ERROR 
Type XXX detail card wrong. 
Program terminates; feastbility condition: NO. 
1112 x XXX CARD SEQUENCE ERROR 
Type XXX detail card not in the proper order (e.g. correction 


cards not arranged in ascending segment number order), 
Program terminates; feasibility condition: NO, 
1113 x SUB-ORDER CARD ERROR 
Card read cannot be identified. 
Program terminates; feasibility condition NO. 


1114 x TRC-POINT ERROR 


An instruction having a length of 2 is found at the specified program 
address as given in the detail card TRC. 
Program terminates; feasibility condition: NO. 


1115 # OVERFLOW OF TRC TABLE 


More than 15 entry points requested on the trace routine, 
Program terminates; feasibility condition: NO. 


1116 x OVERFLOW OF GENERATE PROGRAM 


The generated program exceeds the size of the memory. 
Program terminates; feasibility condition: NO, 
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1117 x SEGMENT NOT FOUND 


Program does not contain a segment with the same number as 
indicated in the TRC or CRT cards. 
Program terminates; feasibility condition: NO. 


1118 x OVERFLOW OF PROGRAM 


The program file, after the generated program is inserted, exceeds 
the area reserved for it. Program terminates; feasibility 
condition: NO. 


1198 x PROGRAM FILE NOT AVAILABLE 


This message indicates that due to the last error indication, the 
program file can no longer be used. 


7. EXAMPLE 


To carry out a basic language correction to the program FASE2 and delete 
all debugging programs from the file, and replace two 6-character 
instructions by two other similar ones, the order card must contain the 
following: 

Col. Lto 4 eDPG 

Col. Sto 9 FASE2 

Col. 10 to 12 B... B 

Col. 13 x 

Col. 14 to 80 B...B 


and must be followed by a detail card CRT with the following punches on it: 


Col. 1lto 4 ¥CRT 
Col. Sto 6 o1 
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Col. Tto 8 0c 
Col, 9 to 12 0804 


Col. 13 to 36 = D201‘ O7B4 O7FE D201 O7F6 0795 
Col. 37t080 =o B... B 


The END card must be punched as follows: 
Col. 1to 4 BEND 
Col. 5 to 80 Blank, 
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oDIL DISC LOAD 


1. FUNCTION 


To write data on dise from card input; for data on a program file, cards 


will have a "program" format, and for data on a data file, cards will have 
a "data" format. 


2, SYSTEM UNITS REQUIRED 


The following peripherals are needed: 
- adise unit for recording data, 


a disc unit for the System Disc, if the unit to be used for recording 
is not the System Disc, 


- ecard reader, 


- printer. 
3. PARAMETER CARDS 


3.1. ORDER CARD 
The format of the order card is: 


Col. Lto 4 Order identification code: eDIL 


Col, Sto 6 Logical dise unit (punched in column 6) containing the 
volume to be recorded; punch SD if the volume is the 
System Disc. 

Col. 7 ¥ if the recorded cards are not to be printed. 


1 or any other character to print cards. 
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Col. 8 to 72 Not used 
Col. 73 to 80 Serial code (if desired). 


8.2. DETAIL CARDS 
Cards for recording are arranged in pages with a maximum length of 2048 
characters; at the end of the card deck, an END card indicate the end of 
the job. 
3.2.1, "Program" Cards 


Each group of cards making up one dise page must be preceded by a 
“beginning of page” ecard, having the following format: 


Col. 1to 5 Dise address (in decimal form) of the page 
beginning. Right hand zeros must be punched as 
well. 

Col. 6 Write recording mode 


- 1 for 8-bit mode 
~ 2 for 6-bit mode. 


Col. 80 x 
The cards making up dise page have the same format as packed APS 
eards (in pure or coded hexidecimal form). 


Col. Lto 4 Code of the program to be loaded (this area is 
not used by eDIL ). 


Col, 5to 6 Length (in hexadecimal) in memory characters of 
the part of the program punched in columns 11 
to 70, 


Col. 7to 1d Address of memory insertion of the part of the 
program punched in columns 11 to 70. 
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Col. 11 to 70 Part of the program to be recorded 
Col. 71 to 79 Not used 


Col, 80 ¥ or any other character except Sand x. 
3.2.2, "Data" Cards 


Each group of cards making up a page is preced by a "beginning of page" 
card. This card is easily recognizable, ag it contain punches in the first 
8 columns, whereas all other cards for that page are blank in the first 

8 columns. 


All "data" cards have an S in column 80, 
The format for data cards ig: 
Col. lto 5 Sector number at which the page begins. All 
right hand zeros must be punched. 


Col. 6 Recording mode: 


- 1 for 8-bit mode 
- 2 for 6-bit mode 


Col. Tto 8 Number of cards making up page including 
beginning of page card. 
All right hand zeros must be punched as well. 
Data included in columns 1 through 8 are only to 
be punched in the first card of each page. 


Col. 9to10 Length, in memory characters, of data punched 
in columns 11 to 70. 
Right hand zeros must also be punched. 


Col, 11 to 70 Data to be written 
Col, 71 to 78 Not used 
Col, 79 Mode of punching. 


~ 1 for hexadecimal 
- 2 for alphanumeric, 
Col. 80 Ss 
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DESCRIPTION AND EXECUTION 


This program is made up of a single segment located at address 2048 
(decimal); the program functions in two different ways, depending on whether 
a program or data file is to be written. 


Data is always transcoded (if it is not in pure hexadecimal) and unpacked. 


Once a "beginning of page” card is read and the information it contains 

is recorded, the first data card is read and the storage address punched in 

the card is recorded. The data is then entered into the memory at the 
beginning of the page area and over the length indicated. The following cards 
are then located on the page at their relative addresses, using the address of 
the first card and the address punched in the card as the bases. Extra locations 
remaining after a page is recorded are filled with spaces. 


The program checks that no page has cards with an input address lower 
than that of the beginning page card (message N° 0513) and that no page 
exceeds the maximum length of 2048 characters (message N° 0514), 


A page formulated in the memory in this way is recorded ona dise for 
every card containing an asterisk (x) in column 80 or for every END card 
read, 


"DATA" CARDS_ 


If column 79 contains a1, data is converted (if it is in coded hexadecimal) 
and packed; if column 79 contains a 2, the data is stored in the page as 
punched. 


Cards are entered in a page one after the other; the page is recorded on a 
dise whenever the number of cards read is equal to the number punched in 
columns 7 and 8 of the beginning of page card. Once a page is recorded, 
reading of a card which is not a beginning of page card or an END card 
(message No 0510) is signalled as an error; error signals are also caused 
whenever a card with a punch other than S$ in column 80 is read before 

the proper card number is passed, or if a card indicating the beginning of 
a new page is read (message N° 0516). 
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5, CHECKSAND ERROR MESSAGES 


Program checks on peripheral unit operation, on order card or detail card 
validity, and may give rise to the following printed messages: 


0501 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying logical disc n. 
Program terminates; feasibility condition: NO. 


0502 # D. UNIT N OUT OF ORDER 


Logical dise unit n Signalled out of order The program causes the 
printer to move the paper to a new page and the program halts at 
location 01DA. Pressing RUN retries the operation that caused 
the signal. If the signal repeats, the program terminates. 
Feasibility condition: NO. 


0503 x D. UNIT N PERSISTENT ERROR 


Positioning error on logical disc unit n. 
Program terminates; feasibility condition: NO. 


0510 x FIRST BLOCK CARD WRONG 


Indicates an error on beginning of page card for "program" or 
"daia" file). This message is caused by one of the following errors: 


a) 
d) 


¢) 
q@) 


e) 


Error in column 80. 


Columns I to 10 of a beginning of page card containing an § 
in column 80 have punches that are not numerical or blank 
spaces, 


Disc Address (Col. 1 to 5) greater than 19999. 


Length of a data greater than 60 or equal to 0 on cards with 
an S in column 80. 


Column 1 to 6 of a card with an asterisk (x) in column 80 
contain non numeric characters. 
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f Column 6 contains punches other than 1 or 2. 


The program terminates; feasibility condition: NO. 


0511 x COLUMN 80 WRONG 


Program card (other than a beginning of page card) has an S or # 
in column 80, 


Program terminates; feasibility condition: NO. 
0512 x OBJ. PROG. CARD NOT EXAD 
Program card (other beginning of page card) has punches that are 
not hexadecimal . 
Program terminates; feasibility condition: NO. 
0513 x OBJ. PROG. CARD ADD. TO LOW 
Program card has an address inferior to that of the page. Program 
terminates; feasibility condition: NO. 
0514 x OVERFLOW OF BLOCK 
The last character to be stored exceeds the maximum page size 
(2048 characters), Program terminates; feasibility condition: NO. 
0515 x OBJ. PROG. CARD LENGTH WRONG 


The area punched in columns 5 and 6 of a program card, which 
represent the length of the data, is equal to zero or greater than 
30. 
Program terminates; feasibility condition: NO. 

0516 xDATA CARD WRONG 


This error message may be caused by one of the following cases: 


a) A beginning of card page ia read before all the data cards 
for a page have been read. 


b) The area punched in columns 9 and 10 of a data card containg 
non numeric values. 
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c) The value of the area punched in columns 9 and 10 of a 
data card is equal to zero or greater than 60. 


Program terminates; feasibility condition: NO. 


0517 x COL. 79 DATA CARD WRONG 
Col. 790 .2 data card does not contain a 1 or a 2. 
Program terminates; feasibility condition: NO. 
0518 x DATA CARD NOT EXAD 


Non hexadecimal characters are punched in the data area 
(columns 11 to 70) of a data card with a 1 in column 79. 
Program terminates; feasibility condition: NO. 


0519 x ORDBR CARD WRONG 


Error in the format of an order card. 
Program terminates; feasibility condition: NO. 


6. EXAMPLE 
To record a sample file on the System Disc and then to print cards making 


up this file, the order card should have the following structure: 


Col. Lto 4 eDIL 
Col. Sto 6 sD 
Col. 7 5 


This will be followed by the sample file cards, punched in the same way as 
"date" cards, and then by the END card. 


170 


oO 


DISC OPERATING SYSTEM 


eDIP Disc PRINT 


1. 


2. 


FUNCTION 


To print specified disc areas containing any kind of data. 


SYSTEM UNITS REQUIRED 


The Dise Print program uses the following peripherals: 


- a disc unit containing the areas to be printed 


- adise unit containing the System Disc, if the data to be printed is not 
recorded on SD 


- a printed, 


PARAMETER CARDS 


The Dise Print program uses only the order card with the following format: 


Col. lto 4 Order identification code: eDIP 


Col. 5to 6 Logical disc unit (punched in column 6) of the unit 
containing the volume to be printed; if this is the 
System Disc, punch SD. 


Col, 7 Recording mode: 


- 1 for 8-bit mode 
- 2 for 6-bit mode 
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Col. 8 to 12 Initial sector of the area to be printed. Punch all 
right hand zeros as well, 


Col. 13 to 17 Final sector of the grea to be printed. 
Punch all right hand zeros as well. 


Col. 18 to 28) 


Col, 29 to 39 7 ; a 
Five other possible parameter groups for printing 

ciara: other areas, when required. 

Col, 51 to 61 ? * ‘equired, 

Col. 62 to 72) 


Col. 7% to 80 Serial code (if desired). 


This program is made up of a single segment located at address 2048 
(decimal), 


Printing starts with the volume label; then come the various areas, sector 
by sector, as requested and with the same structure as the "memory print" 
order. The corresponding address is printed in the first five columns of the 
first line. 


As can be deduced by their format, order cards can print up to a maximum 
of six areas each, 


CHECKS AND ERROR MESSAGES 


Checks on peripheral units and on card punches may give rise to the 
following messages: 


0401 x D, UNIT N PERSISTENT ERROR 


Persistent error in reading logical dise unit N. 
Program terminates; feasibility condition: NO. 
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0402 x D. UNIT N OUT OF ORDER 


Logical disc unit N signalled out of order. 
The program causes the printer to move the paper to a new page 
and halts at location 01DA. 
Pressing RUN retries the operation that caused the signal. 
If the signal repeats, the program terminates and the feasibility 
condition is: NO. 
0403 x D. UNIT N PERSISTENT ERROR 
Persistent positioning error on logical disc unit N. 
Program stops; feasibility condition: NO. 
0410 x ORDER CARD WRONG 
Wrong parameters in columns 7 to 72. 
Program stop; feasibility condition: NO. 


0411 » DISC UNIT N NUMBER WRONG 


Wrong parameter in columns § and 6 of the order card. 
Program stops; feasibility condition: NO. 


EXAMPLE 
To print the following areas of the SD: 
~ sectors 00002 to 00019 


- sectors 19630 to 19642 in 8-bit mode 
~ sectors 19690 to 19791 in 8-bit mode 
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The order card should be purched as follows: 


Col. 
Col, 
Col, 
Col. 
Col. 
Col. 
Col. 
Col. 
Col. 
Col, 
Col. 
Col, 
Col. 


1-4 
5- 6 
7 

8-12 
13-17 
18 

19 = 23 
24 - 28 
29 

30 - 34 
35 ~ 39 
40-72 
73 - 80 


@DIP 
sD 
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oFLP FILE LABEL PRINT 


1. FUNCTION 


To print the labels for files within a volume, the volume label and the free 
area table. 


2. SYSTEM UNITS REQUIRED 


The File Label Print program requires the following peripherals; 


- adisc unit on which the System Disc is installed 
- another disc unit, if labels to be printed are not on the SD 


-  aprinter. 


3. PARAMETER CARDS 


The program requires only the order card with the following format: 
Col. Ito4 eFLP 


Col. 5to6 Logical dise unit number (punched in column 6) of the 
unit on which the volume containing the labels to be 
printed is installed: 


SD if this is the System Dise 
Col. 7 to 72 Not used. 
Col. 73 to 80 Serial code (if desired). 
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The File Label Print program is made up of a single segment stored at 
location 2048 (decimal) in the memory. 


CHECKS AND ERROR MESSAGES 


The program checks peripheral unit operation and the validity of the 
parameter card and, when an error is found, prints one of the following 
messages: 
1201 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading logical dise unit N. Program 
terminates; feasibility condition: NO. 
1202 x D. UNIT N OUT OF ORDER 
Logical disc unit N signalled out of order. 
The program causes the printer to move the paper to a new page 
and halts at location 01DA. 
Pressing RUN retries the operation that caused the signal. If the 
signal repeats, the program terminates; feasibility condition: NO. 
1203 x D. UNIT N PERSISTENT ERROR 
Positioning error on logical dise unit N. Program terminates; 
feasibility condition: NO. 
1210 x ORDER CARD ERROR 
Columns 5 & 6 of the parameter card contain wrong punches. 
Program terminates; feasibility condition: NO. 
1211 x NOT FOUND UNIT N 


No logical dise unit N included in peripherals. Program terminates. 
feasibility condition: NO. 
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To print the labels of the volume installed on logical, dise unit 1, the 
order card should be punched as follows: 


Cal. Llto 4 eFLP 
Col. 5to 6 v1 
Col. 7 to 80 Blank. 
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oCRD CARD DUMP 


To print all cards following the order card until an end of print card 
appears, 


2, SYSTEM UNITS REQUIRED 


The Card Dump program uses the following peripherals: 


-  adise unit for the SD 
-  aprinter 


-  acard reader. 


3. PARAMETER CARD 


The Card Dump Program uses an order card and a detail card. 


3.1. ORDER CARD 


Col, 1to 4 Order identification code: eCRD 
Col. 5 to 72 Not used 


Col. 73 to 80 serial code. 
3.2, END OF PRINT CARD 


This is the last cird in the deck of cards to be printed. 


178 


6. 


DISC OPERATING SYSTEM 


Col. 1to 4 Identification code: #... 
Col. 5 to 80 Not used, 


DESCRIPTION AND EXECUTION 


The program reads and prints at the same time in the following manner: 
a card is read, stored in the print area and, when a new card is being 
read, the preceding card is printed. This process continues until the 
end of print card is read. 


All cards are printed, including the order card, and a line space is left 
between each card, 


CHECKS AND ERROR MESSAGES 


To read cards, the program uses the card read and print routine. In case 
of a print error, the character # is printed in the first position of the 
line containing the error. The following message is printed at the end of 
the job: 


2299 x END OF CARDS DUMP 


EXAMPLE 


To print a given deck of cards, an order card is punched and placed at the 
beginning of the deck and an end of print card is placed at the end. 

These cards are punched as follows: 

1. Order Card 


Col. lio 4 eCRD 
Col. 5 to 80 Blank 
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2, End of Print card 


Col. 1to 4 B... 
Col. 5 to 80 Blank, 
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eMDP MEMORY DUMP 


FUNCTION 


To print the contents of a certain specified area of the memory as requested 
by the user. The whole memory can be printed, or the reserved area or 

the areaavailable for programs.The reserved area is regenerated each time 
Pilot Zero is loaded, therefore the list of the reserved area has no meaning. 


In order to print the reserved area must be used the COS memory dump 
program (see Utility Programs/COS; program code 0201). 


To print the part of the reserved area preceding 01CO must be used the 
COS memory dump program (see Utility Programs/COS; prog. code 0219), 


PARAMETER CARDS 


Memory Dump requires only the order card with the following format: 


Col. Lto 4 Order identification code eMDP 


Col. 5to 8 Initial address of the memory area to be printed; 
address in coded hexadecimal. 


Col. 9to012 Final address 
Col. 13 to 72 Not used, 
Col. 73 to 80 Serial code (if desired). 
If the initial address is not specified, printing begins with the first 


address left free by the programs; if the final address is not specified, 
printing stops at the end of the memory. 
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DESCRIPTION AND EXECUTION 
The order is executed by the memory print program which is part of the 
Basic Program and is initiated by Pilot 1. 


Memory contents are printed out in two lines: one hexadecimal and the 
other in graphic characters in their normal form. 


First the name of the last program being executed is printed out in the 
following manner: 


9012 x MEMORY DUMP OF PROGRAM X... X 
At the end of printing, the following message is printed: 


9099 x END OF MEMORY DUMP, 
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eSPD SYSTEM DISC PRINT AND DUPLICATE 


1. FUNCTION 


To duplicate, on the volume indicated, the program file located on the 
System Disc or the Library Disc and if required, to print a program file 
index and the index of the library of Subroutines forming part of the file, 
or simply to print the index without duplication. 


2. SYSTEM UNITS REQUIRED 
The System Dise Print and Duplicate program uses the following peripherals: 


~- a disc unit on which the SD or LD is mounted 
- a second diac unit if duplication is desired 


- a printer. 


3. PARAMETER CARDS 


The program requires just the order card, with the following format: 
Col. 1to 4 Identification code: eSPD 
Col. 5 May contain one of the following values: 


- to duplicate the program file and print the 
program file index of the duplicated volume. 


- D if duplication only is desired. 
~ P if print only is desired. 
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Col. 6 and 7 Logical number, punched in column 7, of the dise 
unit on which the program file indicated is being 
recorded; these columns remain blank if only the 
labels are to be printed (P punched in column 5). 


Col. 8 to 72 Not used 
Col. 73 to 80 Serial code (if desired), 


DESCRIPTION AND EXECUTION ras 


The program is made up of two segments. 


It first checks the validity of the order card and, if program file duplication 

is desired, it checks that the volume involved in the duplication contains a 

file label in which the first two characters of the name are the same as on 

the file to be duplicated. Oo 


This label first has to be recorded by an earlier eFLW order. 


The program then duplicates the file and prints the file index at the same 

time or either prints the index or duplicates the index only. 

The following data is, however, always printed: 

- volume label, free area table and original volume file label. oO 


- if duplication is desired, the volume label, free area table and program 
file table of the dise on which the program file is being recorded. In 
such case, before printing the new file labels, the following message 
is printed: 


NEW DISC LABEL AND FILE LABEL 
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CHECKS AND ERROR MESSAGES 


The program checks the operation of dise units and the validity of parameters 
punched in the order card. 


When an error is found, it is indicated by one of the following messages: 


0901 x D. UNIT N PERSISTENT ERROR 
Persistent error in reading, writing or verifying logical disc unit 
N, The program terminates; feasibility condition: NO. 

0902 x D. UNIT N OUT OF ORDER 


Logical dise unit N signalled out of order. The program causes 

the paper on the printer to move to 2 new page and halts at location 
O1DA; pressing RUN retries the operation that caused the signal. 

If the signal repeats, the program terminates. Feasibility condition: 
NO. 


0903 x D. UNIT N PERSISTENT ERROR 
Positioning error on logical disc N. Program terminates; feasi- 
bility condition: NO. 

0910 x ORDER CARD ERROR 
Unrecognizable codes punched in column 5 of the order card. 
Program terminates; feasibility condition: NO. 

0911 x DISC UNIT N CODE ERROR 


Wrong data in column 6 & 7. This check is only carried out if 
there is a P punched in column 5. 
Program terminates; feasibility condition: NO. 
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0912 x OVERFLOW OF PROGRAM FILE TN... N LAST PROGRAM 


The program file to be recorded on the volume indicated is 

greater than the area reserved for it. 

Transcription of the file terminates; the last program te be recorded 
correctly was a type Tnamed N... N. 

For an overflow during transcription of the subroutine library or 

the first program the following message is printed as the second 
line: 


NEW FILE ZONE TOO SMALL 


In the former case, the new program file can be used to the 
program indicated in the message; in the latter case, it cannot be 
used at all. The program terminates; feasibility condition: NO. 


0913 x NEW PROGRAM FILE NOT AVAILABLE 


When a new program file is being recorded, an error occurs 
which will prevent its future use. (e.g. error in recording the 
program file index). The program terminates; feasibility 
condition: NO. 


0914 x UNIT N SD (LD) NOT FOUND ON PROGRAM FILE LABEL 


The identification name of the file label of the volume on which 
recording is being carried out is not the same as the one on the 
volume to be duplicated. The program terminates; feasibility 
condition: NO. 


0916 x UNIT N PROGRAM FILE LABEL NOT FOUND 


The program file label is not found on the volume being recorded. 
The program stops; feasibility condition: NO. 
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EXAMPLE 


To duplicate the program file of the library disc into the volume mounted 
on logical disc unit 3, and to print the program index and the subroutine 
library index at the same time, the order card should be punched as 
follows: 

Col. 1lto 4 esPD 

Col, 5 ¥ 

Col, 6and7 43 

Col. 8 to 72 B...#B 

Col, 73 to 80 W...KB 
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SDC SYSTEM DISC CLOSE 


FUNCTION 


To delete from the system disc program file all programs following the 
program specified on the order card. 


SYSTEM UNITS REQUIRED 


The System Dise Close uses the following peripherals: 


- a dise unit on which the System Disc is mounted 


- a printer. 


PARAMETER CARDS 


System Disc Close requires only the order card with the following 
format: 


Col. 1to 4 Order identification code : eSDC 


Col, 5 Code indicating the type (1 or 3) of the last program to 
keep in the program file. 


Col. 6 to 13 Name of the last program to keep. 
Col, 14 to 72 Not used. 
Col. 73 to 80 Serial code (if desired). 
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DESCRIPTION AND EXECUTION 


The program is made up of a single segment located at address 2048 
(decimal). It seans the program file directory for the record relative to 
the program specified in the order card and writes the character E (end 
of index) after it. 


It then updates positions 60 to 64 of the program file label, which contain the 
address of the first free sector. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of the disc units and the validity of para- 
meters punched in the order card. When an error is detected, it is indicated 
by one of the following messages: 


0601 x D, UNIT N PERSISTENT ERROR 


Persistent error in recording, reading or verifying logical disc 
unit N. 
Program terminates; feasibility condition NO, 


0602 x D. UNIT N OUT OF ORDER 


Logical disc unit N signalled out of order. The program causes 
the printer to move the paper to the next page and halts at 
location O1LDA. 

Pressing RUN retries the operation that caused the signal. If the 
signal repeats, the program terminates and the feasibility 
condition is NO, 
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0603 x D. UNIT N PERSISTENT ERROR 


Positioning error on logical dise unit N. 
Program terminates; feasibility condition: NO. 


0610 x PROGRAM NAME NOT FOUND 


The program specified in. the order card is not found in the 
program file. The program terminates; feasibility condition: NO. 


0611 x PROGRAM CODE ERROR 


Type code punched in column 5 of the card is not 1 or 3. 
Program terminates; feasibility condition : NO. 


0698 x PROGRAM FILE NOT AVAILABLE 


This message indicates that, as a consequence of the last 
message printed, the program file is not usable. 


EXAMPLE. 
To close the SD after type 3 program whose name ig AGGIOR, the order 


card should be punched as follows: 


Col. 1to 4 eSDC 
Col. 5 3 

Col. 6 to13 AGGIOR. 
Col. 14 te 80 Bb... KB 
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eCZD CYLINDER ZERO DUPLICATE 


4, 


FUNCTION 


This order copies Cylinder Zero of a System Dise onto another disc. 


SYSTEM UNITS REQUIRED 


- a printer 


~- two dise units, one for the SD, the other for the disc being updated. 


PARAMETER CARDS 


This program requires only the order card with the following format: 


Col. lto 4 eCZD 

Col. Sto 6 logical unit number, of the disc being updated, punched 
in col. 6 

Col. 7 to 72 not used 

Col. 78 to 76 optional ID code 

Col, 77 to 80 not used 


DESCRIPTION AND EXECUTION 


The program is madeup of a single segment. 
It checks that the disc being updated was not declared on the same unit of 


the SD, then copies Cylinder Zero. 
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5. CHECKS AND ERROR MESSAGES 


3601 * D, UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifiying the logical 
number of unit N. 

Program execution stops at location 02A6. 

Feasibility condition: NO. 


3602 * D. UNIT N OUT OF ORDER 


Dise unit N out of order. The program causes the printer to move 
the paper to a new page and halts at location 0LDA. Pressing Y 
START retries the operation that caused the signal. If the signal 
repeats the program halts at location 02A6; feasibility condition:NO, 
3603 + D. UNIT N PERSISTENT ERROR 
Persistent positioning error on dise unit N. 
Program execution stops at location 02A6; feasibility condition:NO. 
3605* D. UNIT N NOT CONNECTED 
The dise unit, whose number appears in col, 6, is not connected 
to the system. 
3620 * DISC NUMBER ERROR 


Wrong number punched in col. 6 
Program execution stops at location 02A6. oO 
Feasibility condition: NO. oO 


3621 * OUTPUT DISC IS SYSTEM Disc 


Logical unit number wrong: the number specified in col. 6 is the 
same assigned to the System Disc. Program execution stops at 
location 02A6; feasibility condition: NO. 
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3699 * END OF CYLINDER ZERO DUPLICATE 


End of program. 


EXAMPLE 


For duplication of Cylinder Zero of an SD, mounted on unit 0 (zero), onto 
an output disc mounted on unit 2, punch the following card: 


Col. lto 4 eczD 
Col. 5to 6 he 
Col. 7 to 80 Blank 
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eSDU SYSTEM DISC UPDATE 


To update and modify the SD in the following ways: 


a) insert a new program 
b) modify the label of 2 program 
c) replace one or more program segment (s) 


d) insert one or more segment (s) in a program 


Programs may be of type 1 or type 3. 


2, SYSTEM UNITS REQUIRED 


The program uses the following peripherals: 

- adisc unit on which the System Dise is mounted 
-  areader to enter detail cards 

-  aprinter. 


3. PARAMETER CARDS 


The program requires an order card and-several detail cards. 
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ORDER CARD 
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The format of the order card is: 


Col, 
Col, 
Col, 


lto 4 
5 to 72 


78 to 80 


eSDU 
Not used 


Serial code. 


DETAIL CARD PLC (Program Label Create) 


This card generates a new program label. It is uged whenever 2 new 
program is inserted in the SD or when an existing program is replaced. 


The PLC card must, therefore, be followed by one or more SIN (Segment 
Insert) card(s) used to insert each segment of the program, 


The PLC card also contains the name of the program to be inserted, This 
name will be added to the file index. 


The format of the PLC ecard is as follows: 


Col. 
Col, 
Col. 
Col, 


lto 4 
5 
6 to 13 
14 


Identification code: BPLC 
Program type code (1 or 3) 
Program name 


Code indicating the input/output routine used by the 
program, 


¥ = program uses a tape management routine 

1 = program uses a dise management routine 

2 = program uses a tape and a disc management 
routine 

3 = program uses neither tape nor dise management 
routine, 
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Col. 15 to 23 Program type code (1 or 3) and program name. 
These columns are used when the program name is to 
be changed. 


Col. 24 to 27 Address of the file table, in coded hexadecimal. 
Punch 0000 if the file table is missing. 


Col. 28 to 31 Starting address of the program, in coded hexadeci- 
mat, 


Col. 32 to 35 Final address of the program plus one, (coded 


hexadecimal), a 


Col. 36 1 - if the program is not included in the SD and 
must therefore be inserted. 


R - if a program with the same name, but which is 
to be replaced, is included in the SD. In this 
case, the existing program is deleted. 


Col. 37 to 42 Date, expressed as Byyddd. ‘ 
Col. 43 to 80 Not used. 


‘SIN (Segment Insert) DETAIL CARD 


This card is used to insert a segment, 


It is placed before the program cards for the segment to be inserted. 
If the next segment is part of a whole program which is newly created, oO 
@ PLC card must be placed before the first SIN card. This ts unnecessary, (3) 


however, in the case of a segment which is already part of an existing 
program, 


The format of the SIN card is as follows: 


Col. lto 4 }SIN 
Col. 5 Program type code (1 or 3) 
Col. 6 to 13 Name of the program to which the segment belongs. 
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Col. 
Col. 
Col. 


oO Col. 


Col. 
Col, 


16 to 19 
20 to 21 
22 to 32 
33 to 36 


37 to 42 
43 to 80 
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Number (decimal) of the program segment on the 
dige after which the segment made up of object 
program cards following this card is to be 
inserted. 


This number is not used for the SIN cards following 
this first deck, as any other segments will be 
inserted after the first one. 

This number is not used for the SIN cards following 
this first deck, as any other segments will be 
inserted after the first one. 

The first SIN card is numbered 00 when the first 
segment or a new program (PLC card with code I) 
is inserted. 


Number (decimal) of object cards in the segment. 
Number (decimal) assigned to the segment. 
Not used. 


Number (decimal) of cards making up the segment 
preceding ‘the present card, if any 


Date expressed as Kyyddd 
Not used. 


3.3.  SRP(Segment Replace) DETAIL CARD 


£f The SRP card ig used to replace an existing program segment. It ig 
followed by program cards for the segment to be replaced. 


The format of the SRP card is ag follows: 


Col. lto 4 
Col, 5 

Col. 6to13 
Col. 14 to15 


SRP 

Code (1 or 3) of the program to be modified 
Name of the program to be modified. 

Number (decimal) of the segment to be replaced. 
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Col. 16 to 19 Number (decimal) of object program cards making 
up the segment. 


Col, 20 to 32 Not used. 


Col. 33 to 36 Number (decimal) of cards making up the segment 
preceding the present card, if any. 


Col. 37 to 42 Date expressed as Kyyddd 
Col. 43 to 80 Not used. 


3.4. END OF ORDER CARD 


The end of the detail cards is indicated by the END card which is punched 
as follows: 

Col. Lto 4 BEND 

Col. 5 to 32 Blank 


Col. 33 to 36 Number (decimal) of cards making up the segment 
preceding the present card, if any. 


Col. 37 to 42 Date expressed as Byyddd 
Col. 43 to 80 Not used. 


4. DESCRIPTION AND EXECUTION 
This program is made up of two segments located at memory address 2048 
(decimal). 
The program may be used to insert a new program in the SD, to modify 


or replace part of an existing program in the SD. 


In the former case, segment blocks have a maximum length of 1024 
characters and are inserted at the end of the program file, which may 
mean deletion of type C programs. 
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In the latter case, the program carries out the following operations in 
sequence: 
- insertion of a new program at the end of the program file, 


- insertion of the program name, at the end of the file index, and 
deletion of type C programs from the index, 


- deletion of the former program name from the index when an 
existing program is replaced, 


-  trascription of the entire file, at the same address, so that sectors 
taken up by the deleted program are again occupied, and then 
reorganization of the linking between pages and labels. 


The date punched on the first detail card that has been read or, if no date 
is punched, the day's date, is always written in the program label. 


1301 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying logical dise unit N. 
The program stops; feasibility condition: NO. 


1302 # D. UNIT NOUT OF ORDER 


Logical dise unit N reported as out of order, The program causes the 
printer to slew the paper to a new page and the program halts at 
location 01DA. Pressing RUN retries the operation that caused the 
message. If the message repeats, the program stops. Feasibility 
condition: NO. 


1303 x D, UNIT N PERSISTENT ERROR 


Persistent positioning error on logical disc unit N. Program 
terminates; feasibility condition: NO. 
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1310 x SUB ORDER CARD ERROR 
Wrong detail card read. Program terminates; feasibility condition: NO. 
1311 x SUB ORDER CARD COLUMN NN ERROR 
The area starting at columns NN of the previously printed is wrong. 
Program terminates; feasibility condition: NO. 
1312 * MULTIPLE PROGRAM NAME 


Request to insert a program (PLC card with code I) which is already 
ineluded in the program index. 
Program continues; feasibility condition: NO. 

1313 x PROGRAM NOT FOUND 


Program to be updated is not included in program file. 
Program terminates; feasibility condition: NO. 


1314 x OVERFLOW OF PROGRAM TABLE 
The number of programs in the SD index has reached its maximum 
of 259, Program terminates; feasibility condition: NO. 

1315 x SUB-ORDER CARD SEQUENCE ERROR 
Detail cards not inserted in correct order. Program terminates; 
feasibility condition: NO. 

1317 x CARD OF OBJECT PROGRAM ERROR 
Incorrect program card read for insertion. The program stops; 
feasibility condition: NO. 

1318 x SEGMENT NUMBER ERROR 


Incorrect error segment number punched in SIN or SRP cards. 
The program stops: feasibility condition: NO. 
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1319 x PROGRAM CODE ERROR 


Incorrect program code is card to be inserted. The program stops; 
feasibility condition: NO, 


1320 # CARD COUNTER ERROR 


Number of cards making up a segment not the same as the number of 
cards specified in the SIN or SRP card. 

If the number involved is the one punched in cols. 16-19, the 
program. continues. 

Feasibility condition: YES. 

If the number involved is the one punched in cols. 33-36 the program 
stops. 

Feasibility condition: NO. 


1321 x MAX ADDRESS ERROR 


The maximum memory address of the program does not agree with the 
address punched in the program label. The program continues. 
Feasibility condition: YES. 


1822 x SEGMENT NOT FOUND 
The program has no segment with the number indicated in the SRP or 
SIN card. The program stops. Feasibility condition: NO. 

1323 x OVERFLOW OF PROGRAM FILE TN... N LAST PROGRAM 


At the end of recording program file size exceeds that of the area 
reserved for it. 

The program stops and the last program that was inserted 
correctively on the SD is named N... N and is a type T program. 
Feasibility condition: NO. 


1398 x PROGRAM FILE NOT AVAILABLE 


This message indicates that as a consequence of the last message 
printed, the program file can no longer be used. 
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EXAMPLE. 


To insert on the SD, a type 3 program with code 4576 and name FASE 1, which 
is made up of a single segment and requires only card read and write sub- 
routines, start address 2048, end address of the program (containing 100 
cards) 4095, the following three cards should be punched as indicated if the 
day's date is to be written in the program label: 


Other Card: 
Col. lto 4 eSDU 
Col, 5 to 80 Blank 


Col. 5 3 
Col. 6 to 13 FASE1 
Col. 14 3 


Col. 15 to 23 Blank 
Col. 24 to 27 0000 
Col. 28 to 31 0800 
Col, 32 to 35 1000 
Col, 36 I 

Col. 37 to 80 Not used 
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Col. 1to 4 
Col. 5 
Col. 


Col. 


6 to 13 
14and 15 
Col. 16 to 19 
Col, 20 and 21 
Col. 22 to 80 


DISC OPERATING SYSTEM 


¥SIN 

3 
PASE 
00 
0100 
01 


Not used. 


These three cards should be inserted in the order listed and should be 
followed by the program card for the program to be generated. The last 
card should be an END card. The format of this card should be as follows 
if the actual number of cards making up the segment is to be checked the 


one punched in the END card: 


Col. 1lto 4 BEND 
Col. 5 to 32 Not used 
Col. 33 to 36 0100 
Col. 37 to 80 Not used. 
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e Sps SYSTEM DISC STRIP 


1, 


2, 


aR. 


3.1. 


FUNCTION 


To delete type 1 or 3 program from the System Dise, 


SYSTEM UNITS REQUIRED 
To use this program, the following peripherals are needed: 


~ a dise unit on which the SD is installed 
-  aprinter 


~  acard reader. 
PARAMETER CARDS 


The System Disc Strip requires an order card, one or more detail card(s) 
and an END eard. 


Col. 1 to 4 order identification code eSDS 
Col. 5 to 72 not used 
Col. 73 to 80 serial code. 
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DETAIL CARD SDS 


Col. 1to 4 identification code J6DS 
Col. 5 code indicating the type of program to be deleted (1 or 3) 
Col. 6to 13 name of program to be deleted 


Col. 14 code C if the program to be deleted is a type C program. 
Blank otherwise. 


Col. 15 to 80 Not used. 
END CARD 


The end of detail cards is signalled by the END card. 
DESCRIPTION AND EXECUTION 
The program is made up of a single segment located at memory address 


2048 (decimal). 


The program deletes all programs indicated in the detail cards from the 
SD program index. 


At the end, either the index or the entire program file is rewritten to fill 
in blank spaces, and the file label is updated in keeping with the new 
occupation limits. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of peripheral unit used and the validity 
of parameters punched in the cards. 
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When an error is detected, it is indicated by one of the following 
messages: 


1601 x D. UNIT N PERSISTENT ERROR 


Persistent reading, writing or verifying error on logical dise 
unit N. 
Program terminates; feasibility condition: NO. 


1602«D, UNIT N OUT OF ORDER 


Logical dise unit N signalled out of order. The program causes 
the printer to move the paper to a new page and halts at location 
OLDA. 

Pressing RUN retries the operation that caused the signal. If the 
signal repeats the program terminates, 

Feasibility condition: NO. 


1603 x D. UNIT N PERSISTENT ERROR 
Persistent positioning error on logical dise unit N. Program 
terminates; feasibility condition: NO. 

1610 x PROGRAM N... N NOT FOUND 


The requested program is not found in the program type. Program 
continues normally; feasibility condition at the end of execution 
is: NO. 


1611 x PROGRAM CODE ERROR 


Wrong punch in column 5 or 14 ofa detail card, Remove the card 
and processing continues normally: at the end of processing, 
feasibility condition is: NO. 
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1612 x SUB-ORDER CARD ERROR 


An unrecognizable card is read or the END card comes immediately 
after the order card. 
Processing continues normally: feasibility condition at the end of 
processing is: NO. 

1698 x PROGRAM FILE NOT AVAILABLE 


This message indicates that, as a consequence of the last message 
printed, the program file is not usable. 


EXAMPLE 


To delete all type 3 programs from the SD, the following cards should be 
punched: 


Order Card 


Col. 1lto4 eSDS 
Col. 5 to 80 Blank. 
Detail Card 

Col. ito 4 ¥SDS 
Col, 5 3 

Col. 6 to13 Blank 
Col, 14 Bb 

Col. 15 to 80 Blank 


END Card: 


Col, ito 4 BEND 
Col. 5 to 80 Blank. 
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oe SLS SUBROUTINE LIBRARY STRIP 


To delete one or more subroutines from the System Disc subroutine library. 


2, SYSTEM UNITS REQUIRED 


The following peripherals are used by this program: 


~. adisc unit on which the System Disc is installed, 
- a card reader to enter detail cards, 


- a printer. 

3. PARAMETER CARDS 
The Subroutine Library Strip program uses an order card and one or more 
detail cards, 

oe ORDER CARD 


The format of the order card is: 


Col. ito4 Order identification code: eSLS 
Col. 5 to 72 Not used 
Col. 73 to 80 Serial code 
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DETAIL CARD. SLs 


Col. 1to4 Identification code: BSLS 
Col. 5to10 Name of the subroutine to be eliminated 
Col. 11 to 80 Not used, 


END OF ORDER CARD 


Col. 1to 4 ¥END 
Col. 5 to 80 Not used. 


DESCRIPTION AND EXECUTION 


The program is made up of a single segment located at memory address 
2048 (decimal). First, all detail cards are read and printed and the new 
subroutine library directory is generated in the work area. Should an error 
occur during this phase of the operation, the program terminates and the 
program file returns to its initial state. The new subroutine library index ‘ 
is then inserted in place of the former one and, finally, the entire program 
file is again inserted and fills the area freed by the deleted subroutines. 


An error during the latter phase may make the file unusable; at the end 
of the phase, the names of the last program and subroutine entered are 
printed and the file is closed in the normal manner. And, finally, the 
program prints the new subroutine library index after the message: NEW 
INDEX OF SUBROUTINE LIBRARY. 


CHECKS AND ERROR MESSAGES 


The program checks the validity of detail cards and the operation of 
peripherals used, in the event of an error, one of the following messages 
is printed: 


209 


DISC OPERATING SYSTEM 


3101 x D. UNIT N PERSISTENT ERROR 


Persistent reading, writing or verifying error on logical disc 
unit N. 
Program terminates, feasibility condition: NO. 


3102 x D. UNIT N OUT OF ORDER 


Logical dise unit N signalled out of order. 

The program causes the printer to. move the paper to a new page 
and halts at location 01DA. Pressing RUN retries the operation 
that caused the signal. If the signal repeats, the program termi- 
nates; feasibility condition: NO. 


3103 x D. UNIT N PERSISTENT ERROR 
Persistent positioning error on logical disc unit N. Program 
terminates; feasibility condition: NO. 

3110 x SUB-ORDER CARD ERROR 


Error in the format of the detail card: the first four columns do 
not contain }SLS 
The program termi nates; feasibility condition: NO. 


3111 x SUBROUTINE XXXXXX NOT FOUND 
Subroutine XXXXXX specified in the detail card cannot be found 
in the SD library. 
Program continues normally; feasibility condition: NO. 

3197 x NO WORK AREA ON SD 
The SD has no work area, which is needed to generate the new 
subroutine table and to transcribe the file, or the work ‘area on 


the SD is not extensive enough. Program terminates; feasibility 
eondition: NO. 
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3198 x» PROGRAM FILE NOT AVAILABLE 


This message indicates that, ag a consequence of the last 
message printed, the program file is no longer ugable. 


EXAMPLE 


To delete the two subroutines YDIVS and YRD40 from the SD library, one 
order card and two detail cards must be punched as follows: 


Order Card: 


Col. lto 4 eSLS 
Col. 5 to 80 Blank. 


Detail Card: 


1) Col, 1to 4 BSLS 
Col. 5to10 YDIVS 
Col. 11 to 80 Blank 

2) Col, 1to 4 ¥SLS 
Col, 5to10 YRD40 
Col. 11 to 80 Blank. 


END Card: 
Col. ito 4 END 
Col. 5 to 60 Blank. 
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eSLI SUBROUTINE LIBRARY INSERT 


1. FUNCTION 


To insert a new subroutine at the end of the System Disc subroutine library. 
This operation is carried out in three distinct phases: 


a) Standardization of the subroutine to conform with the specific format 
of DOS subroutines; 


b) Insertion of the subroutine in the System Dise library 


¢) Updating the subroutine library index. 


2. SYSTEM UNITS REQUIRED 


The following peripherals are needed to operate this program: 


- a logical disc unit on which the System Disc is installed; 


- a printer. 


3. PARAMETER CARDS 


Subroutine Library Insert uses only the order card with the following format: 


Col, Lto 4 
Col. 5to10 


Col, 11 


Col. 12 to 72 
Col. 73 to 80 


Order identification code: eSLI 


Name of the subroutine to be inserted 


- 1, if the subroutine forms part of EIOS, excluding 
YOPEND, YCLOSD, YNEXTD, YDCKP. 
- blank, if not. 


Not used 


Serial code (if desired), 
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DESCRIPTION AND EXECUTION 


The APS Il compiler supplies the subroutine with three-sector fixed length 
pages written in the 6-bit mode. Only 276-character pages are used. 


Each page contains two logical records with a fixed length of 138 characters 
each, 


The first 80 positions of each record contain the original statement is 
source language or statements generated by a macro-instruction. 


Positions 81 to 110 contain blanks or data which do not concerne the object 
program. 


Positions 111 to 119 may contain error messages; positions 120 to 138 
contain the following data, in pure unpacked binary: 

120 & 121 length of the statement (nn-1 for constants and areas) 

122 & 125 statement address 

126 to 127 operation code 


128 & 129 complement of operation (duplication factor for constants and 
areas) 


130 to 133 address of the first operand or zeros (decimal) 

134 to 137 address of the second operand or zeros (decimal) 

138 O(decimal) 

During the first phase, basic language statements are organized into pages 
having a maximum length of 1200 characters and are set as described 
above, 

Constants of the DC'C' type are handled as follows: 


- they are standardized with spaces to the right when the effective length 
is shorter than specified; 
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- they are unpacked with a quartet; 


- they are duplicated using a duplication factor. 
Constants of the DC'X' type are handled. as follows: 


- they are standardized with spaces to the right when the effective lenght 
is shorter than indicated (nn) 
- they are unpacked with a zone quartet 


- when the duplication factor is greater than 1, the standardized and 
unpacked constant is repeated the number of times indicated by the 
duplication factor. 


Constants of the DC"A" type, however, are considered as statements. DS 
and ORG statements close pages being formulated; data for identifying the 


subroutine are written at the beginning of each page. 


During the second phase, the subroutine is inserted iu the library, after 
the end of the existing subroutines, and the library index is updated, 


Type 3 programs generated by the order eDPG are deleted, 


CHECKS AND ERROR MESSAGES 


The program checks the operation of peripherals and the validity of the 
order card; it also checks the organization of the subroutine and indicates 
errors by means of one of the following messages: 


3001 x D. UNIT N PERSISTENT ERROR 


Persistent reading, writing or verifying error on logical dise 
unit N. 
Program terminates; feasibility condition: NO. 
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Statements *, LF, EJEC are ignored with the exception of statement 

*, read immediately before the END statement, 

In the card relating to the * statement, the user wiil have punched the 
subroutine's generation date (in the form /YYDDD) in columns 31 ~ 36. 
This date will be recorded in positions 8 - 13 of each subroutine block in 
its final form. 


RESTRICTIONS 


The subroutines processed by the order oSLI have the following restrictions: 


-  out-of-sequence statements are not admitted 
- in ALi type DC statements a symbolic address is not admitted 
- De statements with continuation are not admitted 


- in ORG statements the only operand admitted is R. In this case, the 
subroutine's name should begin and end with the letter Y 


- the statement RORG, ESCT, ESGM are not admitted 


~ the name of another subroutine is not admitted as an instruction 
operand. The only exception is when another subroutine is called by 
a JRT or JU instruction. In this case not that the subroutine called 
must be present in the library; also, the eAPS program prints a U 
signal exclusively to show that a jump has been made to another 
subroutine 


- adjustment is not admitted if the operand of a JU or JRT statement 
is the name of a called subroutine. 


3015 * INVALID SUBROUTINE: INSERTION IMPOSSIBLE 
A subroutine is about to be inserted: but a subroutine hearing 
the same name is already present in the library. 


Program execution is interrupted. 
Feasibility condition: NO. 
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3098 x PROGRAM FILE NOT AVAILABLE 


This message indicates that as a consequence of the last message 
printed, the program file is not usable. 


3099 * END OF SUBROUTINE LIBRARY INSERT 


End of program. The order has been correctly executed, 


EXAMPLE. 

To insert the subroutine YMULN, which has just been compiled, the order 
card should be punched as follows: 

Order Card SLI 


Col. 1to 4 eSLI 
Col, 5 to 10 YMULNB 
Col. 11 to 80 Blank. 
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3002 x D, UNIT N OUT OF ORDER 


Logical disc unit N signalled out of order. The program causes 
the printer to move the paper to a new page and halts at location 
O1DA. Pressing RUN retries the operation that caused the signal. 
If the signal repeats, the program terminates. Feasibility condition: 
NO. 
3003 x D. UNIT N PERSISTENT ERROR 
Positioning error on logical dise unit N. 
Program terminates; feasibility condition: NO. 
3010 x INVALID SUBROUTINE: INSERTION IMPOSSIBLE 


Name of the subroutine as read on the order card not the same 
as the one in the work area. 
Program terminates; feasibility condition: NO. 


3011 x INVALID SUBROUTINE: INSERTION IMPOSSIBLE 


Storage address of the subroutine other than 0. Program terminates; 
feasibility condition: NO. 


3012 * INVALID SUBROUTINE: INSERTION IMPOSSIBLE 
Error in the subroutine statements; program terminates; 
feasibility condition: NO. 

3013 x INVALID SUBROUTINE: INSERTION IMPOSSIBLE 


Subroutines requested cannot he found in the library. Program 
terminates; feasibility condition: NO. 


3014 x OVERFLOW OF PROGRAM FILE INSERTION IMPOSSIBLE 


Program file cannot hold the subroutine. Program terminates; 
feasibility condition: NO. 
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@SPC SUBROUTINE PERIPHERAL COMPILE 


1. FUNCTION 


To change the names of peripheral units contained in ceriain specific 
subroutines within the System Dise Library. 


This program uses the following peripherals: 
- adisc unit on which the System Disc is installed; 
-  acard reader for entering detail cards; 


- a printer, 

$. PARAMETER CARDS 
The Subroutine Peripheral Compile program uses an order card and one or 
more detail card (s). 


3.1. ORDER CARD 


Col. ito 4 Order identification code: eSPC 
Col. 5 to 72 Not used 
Col. 73 to 80 Serial code (if desired) 


3.2, DETAIL CARD SPC 
Col. 1lto 4 identification code: ¥SPC 
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Col. 5to 10 Name of the subroutine to be modified 


Col. 11 to 13 Name of the peripheral unit being changed. 


Col. 14 to 16 New peripheral unit name 

Col. 17 to 19 Second peripheral unit name for unit being changed (if 
desired) 

Col, 20 to 22 New second peripheral unit name 


Col. 23 to 80 Not used. 


If there is no second peripheral unit to change, columns 17 and 22 are not 
used. 


END OF ORDER CARD 


Col. 1to 4 KEND 
Col. 5 to 80 Not used 


DESCRIPTION AND EXECUTION 


The program is made up of a single segment located at memory address 
2048 (decimal). 


The program reads, checks and prints a single detail card at a time; for 
each detail card, the program looks for the specified subroutine and changes 


the name of the peripheral unit with a new name indicated on the cards. 


Characters within the subroutine to be changed are located in area "B", which 
is reserved for peripheral unit names. 
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The program checks the peripheral units used as well as the validity of 
punches in the parameter cards; in the event of error, one of the following 
messages is printed: 

3201 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or verifying logical dise 
unit N, 
Program terminates; feasibility condition: NO. 

3202 x D. UNIT N OUT OF ORDER 


Logical dise unit N signalled out of order. The program causes the 
printer to move the paper to a new page and halts at location 01DA. 
Pressing RUN retries the operation that caused the signal. If the 
signal repeats, the program terminates; feasibility condition: NO. 
3203 x D. UNIT N PERSISTENT ERROR 
Persistent positioning error on logical dise unit N. Program 
terminates; feasibility condition: NO. 
8210 # SUB-ORDER CARD ERROR 
SPC not punched in the first four columns of the detail card. 
Program terminates; feasibility condition: NO. 
3211 x SUBROUTINE XXXXXX NOT FOUND 


Subroutines spectfied on the detail ecard not found on the SD library. 
Program continues normally; at the end of execution, feasibility 
condition: NO, 


3212 x PERIPHERALS XXX NOT FOUND 


Peripheral unit XXX not found in the subroutine specified on the 
last detail card, Program continues normally; at the end of 
execution; feasibility condition: NO. 
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3213 x SUB ORDER CARD COLUMN NN ERROR 
Indicates that the area beginning with column mn on the detail 
card is wrong. Program continues normally; at the end of 
execution, feasibility condition is: NO. 

3298 x PROGRAM FILE NOT AVAILABLE 


This message indicates that, ag a consequence of the last 
message printed, the program file is no longer usable. 


To change keypunch 048 in subroutine YP85 so that it is replaced by the 
number 064, the following parameter cards should be punched: 


Order card: 


.* Col. 1to 4 eSPC 
Col. 5 to 80 Blank. 


Detail card: 


Col. 1to 4 BSPC 
Col. 5to10 YP85 
Col, 11 to 13 048 
Col. 14 to16 064 
Col. 17 to 80 Blank. 


These are followed by the END card. 
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oLDU LIBRARY DISC UPDATE 


1. FUNCTION 


This program allows: 


- Generation of a new Library Disc using programs taken from a 
System Disc or Library Disc. 


- Updating of a Library Disc using a System Disc or another Library 
Disc as the basic disc, 


- In this case, new programs may be inserted or existing programs 
may be deleted in the Library Disc, while the file tables of the new 
and existing programs are updated. 

- Updating of a Library Disc using the same Library Disc as the basic 


disc. In this case only obsolete programs may be eliminated or the 
file tables may be altered. 


2, SYSTEM UNITS REQUIRED 


The following peripherals are needed to use this program: 

- two dise units, one for the basic system disc and the other for the new 
Library Dise (a single unit may be used if the basic dise is the Library 
Disc to be updated). 


-  acard reader for detail card input. 


- a printer. 
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PARAMETER CARDS 


This program requires an order card and a number of detail cards 
followed by an END card. 


THE ORDER CARD 


Col. Ito 4 Identification code«LDU 


Col, 5Sand6 Logic device number (¥0 - 69, or WD) on the unit on 
which the volume that is to contain the new Library Disc 
is to be mounted if two dise units are used. 


-  LDecode, ifonly one dise unit is used on which 
the Library Dise is mounted (as in the case of 
updating the Library Disc used also as basic disc) 


Col. 7 to 23 Name of the program file processed, in the case of 
updating, or name of the new file in the case of generation. 


Col. 24 Code specifying the type of work to be done. It may assume 
either of two values: 


x (asterisk), if a new Library Disc is being generated, 
¥ (biank) if updating. 


Col. 25 to 72 Not used. 
Col. 73 to 80 Serial code. 


THE PRM DETAIL CARD (Program Remove) 


This card is used to delete a program from the Library Disc. 


Col. lto 4 Identification code: BPRM 
Col, 5 Code of the program to be eliminated (1 or 3) 
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Col. 6 to 13 Name of the program to be eliminated 
Col. 14.t0 80 Not used. 


The PRM cards must immediately follow the order card. 


3.3. THE PRI (Program Insert) DETAIL CARD 


This card is used to insert a program. 


Col. Lto 4 Identification code: BPRI 
Col. 5 Code of the program to be inserted (i or 3) 


Col. 6 to 13 Name of program forming part of basic disc to be 
inserted in Library Disc. 


Col. 14to 80 Not used. 


3.4, THE PRT (Program Transfer) DETAIL CARD 


This card is used to update the program file table. 


Col. 1to 4 Identification code: PRT 
Col. 5 Code of the program to be modified (always 3) 


Col. 6to18 Number of the program forming part of the Library 
Dise whose file table is to be updated using the LBC 
card - following the PRT card 


Col. 14 to 80 Not used. 


Each PRT card is followed by as many LBC cards (see Appendix, page 310) 
as there are files to be processed. 


3.5. THE END-OF-ORDER CARD 


The end of the detail cards is indicated by an END card. 
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DESCRIPTION AND EXECUTION 


The program consists of four segments with the same memory address of 
1800 (decimal). 


It can perform one of the following functions : 


a) Delete programs from the Library Disc. 
b) Update the file tables of the Library Dise program. 


c) Insert new programs taken from the System Disc or the Library Disc 
with or without modifying their file tables. 


d) Generate a new Library Disc from the System Disc or from another 
Library Dise,. 


Uf the order eLDU requires a single disc unit, only the LD code is present 
in cols. 5 - 6 of the order card and a check is carried out to make sure 
that the volume is a Library Disc. In this case the Library Disc can be 
updated only by means of the PRM and PRT cards. 


If there is a code other than LD in cols. 5 ~ 6 of the order card (i.e. BO - 
B9 or WD), the basic disc may be either a System Disc or a Library Disc, 
while the second volume must be a Library Disc. 


If a new Library Dise is being generated (x in col. 24 of the order card), 
the program accepts only PRI cards; for updating (¥ in col. 24 of the order 
card) all types of detail cards are accepted except when a single disc unit 
is used (LD code in cols. 5 - 6 of the order card); in this case, as has 
already been said, only PRM and PRT cards may be used. 


CHECKS AND ERROR MESSAGES 


The program checks the parameter cards and peripheral units involved, 
Any error will result in one of the following messages: 
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1501 x D. UNIT N PERSISTENT ERROR 


A persistent error in writing, reading or verifying has been 
encountered on the dise unit with logical number N. The program 
stops. Feasibility condition: NO. 


1502 x D. UNIT N OUT OF ORDER 


The unit with logical number N is out of order. The program 
slews the paper to a new page and comes to a HLT at address 
O1DA. 

The operation causing the message is retried by pressing RUN, 
If the message is repeated the program stops. 

Feasibility condition: NO. 


1503 x D. UNIT N PERSISTENT ERROR 
A persistent positioning error has been encountered on the disc 
unit with logical number N. The program stops. Feasibility 
condition: NO. 

15102 SUB-ORDER CARD ERROR 
An undentifiable card has been read. The program stops. 
Feasibility condition: NO. 

1511 x SEQUENCE ERROR SUB-ORDER CARDS 
A detail card has been found out of sequence. The program stops. 
Feasibility condition: NO. 

1512 x LBC-CARD NOT FOUND 
A PRT card has been read which was not followed by an LBC card. 
The program stops. Feasibility condition: NO. 

1513 x D, UNIT N : PROGRAM FILE LABEL NOT EXACT 


The program file label is not the one required. It is printed after 
reading, then the program stops. 
Feasibility condition: NO. 
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1514 x ORDER CARD COLUMN NN ERROR 


Illegal coding in cols. NN of the order card. The program stops. 
Feasibility condi tion: NO, 


1515 x D. UNIT N : PROGRAM FILE LABEL NOT FOUND 


The volume mounted on the disc unit with logical number N has no 
program file label. The program stops. 
Feasibility condition: NO. 


1516 x PROGRAM TN... N NOT FOUND 


Program T, name N... N is missing in program file list. 
The program stops. Feasibility condition: NO. 


1517 x MULTIPLE PROGRAM NAME 


The program whose insertion has been requested is already present 
on the Library Disc. The new program is inserted the same, 
Program execution continues. 

Feasibility condition: YES, 


1518 x SUB-ORDER COLUMN NN ERROR 


The filed starting from col. NN of the card is incorrect. Once the 
ecard has been read the program stops. 
Feasibility condition: NO. 


1519*D. UNIT N: END OF PROGRAMS TABLE NOT FOUND 


The closing character has not been found after reading a page of 
the program table. 

The program wanted has not been found. 

Program execution stops. 

Feasibility condition: NO. 


1520 x OVERFLOW OF PROGRAM FILE N... N LAST PROGRAM 


The zone reserved for the Library Disc is not large enough to 
contain all the programs to be inserted. The last regularly 
inserted program has the name N... N. The program stops. 
Feasibility condition: NO. 
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1521 x NO FILE TABLE 


The program present on the Library Disc to be updated and whose 
file table is to be altered using the PRT card has no file table. The 
program stops. Feasibility condition: NO. 


1598 x PROGRAM FILE NOT AVAILABLE 


Indicates that as a result of the last error encountered, the 
program file can no longer be used, The program stops. 
Feasibility condition: NO. 


EXAMPLE 


The program with code 4002 is to be deleted from the Library Disc, the 
program with code 7004 contained in the SD is to be added and the file 
table of the program with code 8521 contained in the LD is to be updated. 
The dise units involved have the following logical number: LD, 0; SD, 1. 
The following cards must be punched: 


1. QRDER CARD 


Col, lto 4 eLDU 
Col. S5and6 BO 

Col. 7 to 23 LDK 115 
Col. 24 KB 

Col. 25t080 b... 8 


2. PRM DETAIL CARD 


Col. Lto 4 BPRM 
Col, 5 to 12 4002 
Col. 13t080 =... B 
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PRT DETAIL CARD 


Col. lto 4 BPRI 
Col. 5 3 

Col. 6 to13 7004 
Col. 14 to 80 w...w 


. PRT DETAIL CARD 


Col. 1to 4 ¥PRT 
Col, 5 3 

Col. 6to13 8521 
Col. 14 to 80 B...B 


The latter card must be followed by the corresponding LBC cards, 
END card 


Col. lta 4 BEND 
Col. 5 to 80 db... #B 
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eMDG 


1. FUNCTION 


To generate a Master Disc. 


Program making up the Master Dise are taken from the Library Dise or 
the System Disc. 


The file on the Master Dise has the following characteristics: 

- it contains the Monitor program, which automatically links the programs; 

- at the end of each program, a segment 99 is inserted; this segment 
contains all the indications needed by the Monitor to select the next 
program; 

- a segment 0 is inserted at the beginning of each program; this segment 
contains indications for starting up the program referred to. Segment 0 
functions are in accordance with the options specified in UPC detail 
eardg. 

- it always contains program eINT and ePRL. 

The function of segment 99 is to load the Monitor program and to provide 


indications for selecting the new program to be started. The Monitor 
functions in accordance with the options specified in detail card PRE. 


2. SYSTEM UNITS REQUIRED 
The following peripherals are Needed to use this program: 


-  adise unit for the basic disc 


- a dise unit for the volume to be inserted 
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~ a disc unit for the Svstem Disc or the Library Disc, if the program 
file to be written on the Master Disc is on a volume other than the 
basic disc 

-  acard reader for detail card input 


- a printer. 


PARAMETER CARDS 


The program requires the use of an order card and several detail cards, 
followed by an END card. 


THE OTHER CARD 
Col. 1to 4 Identification code : eMDG 


Col. Sto 6 logical number (K0 - 9) of the unit on which the volume 
containing the program file to be written on the Master 
Disc is mounted. SD if the file is the System Dise, LD 
if it ia the Library Dise 


Col. Tto 8 logical number (#0 - K9, or WD) of the unit that is to 
contain the Master Disc 


Col. 9 to 25 name of the file to be assigned to the MD; the first two 
characters must be MD 


Col. 26 to 72 not used 


Col. 73 to 80 serial code. 
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3.2, OPC (Operating System Program Call) DETAIL CARD 


This card is used to insert a type-1 program on the MD. 


Col. 1to 4 Identification code: OPC 
Col. 5to12 name of program to be inserted 


Col. 13 to 80 not used 


3.3. UPC (User Program Call) DETAIL CARD 


This card is used to insert a type-3 program on the MD and to specify the 
corresponding start conditions. 
col. Lto 4 Identification code: BUPC 
Col. 5 to 12 program name 
Col. 18 and14 not used 
- Col. 15 1st preparation code for segment 0; 
- H if there is a halt before start up of the 
Tequested program 
- B otherwise 
Col. 16 and preparation code for segment 0: 


-  » if 0A is to be stored in the memory before 
starting the program 


- § otherwise 
Col. 17 3rd preparation code for segment 0: 
- x if the characters specified in cols. 18 - 49 


are to be inserted in the user data area 
- § otherwise 
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user data (if desired) 


not used, 


PRE (Program End) DETAIL CARD 


This card is used to put on the MD the linkage conditions for the next 


program. 


Between the UPC and PRE cards the user can insert the corresponding 
LBC ecards if the program has a file table. 


Cot. Ito 4 
Col. 5 to 12 
Col. 13 


Col. 14 to 21 


Identification code: BPRE 

name of program involved 

Preparation code for the Moniter. It may assume 

one of the following values: 

1 = start up of a specific type-3 program, selected 
during MD generation 


2 = start up of a type-3 program, selected from 
among two programs specified during MD 
generation, depending on how SWITCH 2 is 


positioned 

3 = read an omer card and start Pilot 0 to execute 
the order. 

4 = stop by eMTS 

5 = start a program selected by the preceding 


program, The number of this program is located 
in card read area. 


Name of type-3 program to be started, if code 1 is 
punched in column 13. 


Name of type-3 program to be started if SWITCH 2 
is not set, Only applicable if code 2 is punched in 
column 13. 
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Col. 22 to 29 Name of program to be started if SWITCH 2 is set. 
Only applicable if code 2 is punched in col. 13. 


Col. 30 to 80 Not used, 


DESCRIPTION AND EXECUTION 


The pr gram consists of three segments: the second segment constitutes 
the order ePRL (which also acts as Monitor). This order is inserted in the 
Master Dise program file. 


The first segment checks the order card and puts the orders ePRL, eINT- 
and #MDS on the Master Dise to be generate. 


The third segment reads the detail cards and inserts the user orders or 
programs specified on these cards. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of peripheral units involved and the 
validity of the parameters punched on cards. 


When an error is encountered, one of the following messages is printed: 


1701 xD, UNIT N PERSISTENT ERROR 


A persistent read, write or check error has been encountered 
on dise unit with logical number N. 
The program stops, Feasibility condition: NO, 


1702 x D. UNIT N OUT OF ORDER 


Unit with logical number N is out of order. 

The program slews paper to the next page and halts. Pressing 
RUN retries the operation that caused the message, If the 
message is repeated the program stops, Feasibility condition: NO. 
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1702 x» D, UNIT N PERSISTENT ERROR 


A persistent positioning error has been found on disc unit with 
logical number N. 
The program stops. 
Feasibility condition: NO. 

1710 x SUB-ORDER CARD ERROR 
An unidentifiable card has been read. The program stops. 
Feasibility condition: NO. 

1711 x SUB-ORDER CARD COLUMN NN ERROR 


The field starting from col. NN of previously read card, is 
incorrect. The program stops. 
Feasibility condition: NO. 

1712 x D. UNIT N : PROGRAM FILE LABEL NOT FOUND 
The program file label has not been found on disc N, The program 
stops. Feasibility condition: NO. 

1713 x SEQUENCE ERROR SUB-ORDER CARDS 
The detail cards area read in incorrect sequence. The program 
stops. Feasibility condition: NO, 

1714 % PROGRAM TN... N NOT FOUND 


Requested type T program named N not included in program file. 
The program ignores the card and continues normally. 


4715 x OVERFLOW OF PROGRAM FILE TN... N LAST PROGRAM 
The program file is larger than the size reserved for it. The last 


regularly written program is a type T program with name N... N. 
The program stops. Feasibility condition: NO. 
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1716 x ORDER CARD COLUMN NN ERROR 
The field starting from column NN is incorrect. The program 
stops. Feasibility condition: NO, 


1717 x D. UNIT N: PROGRAM FILE LABLE NOT EXACT 


The program file label is not the one expected. The label that has 
been read is printed. 
Feasibility condition: NO. 


6. EXAMPLE 


A. Master Disc is to be generated on disc unit 1. The following programs 
are taken from the Library Disc: 


- FLW (type 1) and 4250 4270 4271 (type 3). The programs are to be 
started consecutively, with no interruptions in between; when the 
operation is completed the "end-of-job" stop will be executed. The 
following parameter cards must be punched: 


1. Order Card 


Col. Ito 4 oMDG 

Col. 5to6 LD 

Col. Tand& M1 

Col. 9 to 25 MDESEMPIO 


Col. 26 to 80 Not used. 


2. Detail card OPC 


Col. lto 4 BOPC 
Col. Sto 8 oFLW 
Col. 9to 80 Blank 
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3, First Detail card UPC 


Col. 
Col, 
Col. 
Col. 
Col, 
Col, 
Col. 


lto 4 
5 tol2 
128 & 14 
15 
16 
7 
18 to 80 


¥UPC 


Blank 


4. Corresponding PRE card 


Col, 
Col. 
Col. 
Col, 


Col 


lto 4 
5 to 12 
13 

14 to 21 
. 22 to 80 


PRE 
4250 
1 
4270 
Blank 


5. Second detail card UPC 


Col. 
Cot. 


lto 4 
5 to 12 


Col. 13 & 14 
Col, 15 
Col. 16 
Col. 17 
Col. 18 to 80 


Blank 
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6. Corresponding PRE card 


Col. 1to 4 ¥PRE 
Cot. 5tol2 4270 
Col, 13 1 

Col, 14 to 21 4271 
Col. 22 to 80 Not used, 


1, Third detail card UPC 
Col. 1to4 ¥wUPC 
Col, 5to12 4271 
Col, 13 to 14 Blank 


Col, 15 b 
Col. 16 ‘ 
Col. 17 B 


Col, 18 to 80 Blank 


8. Corresponding PRE card 
Col. 1to4 BPRE 
Col, 5 to12 4271 
Col, 13 4 (end of job) 
Col, 14 to 80 Blank 


9. END card 
Col, Lto4 BEND 
Col. 5 to 80 Not used 


When loading the card reader, all cards must be in strict sequence, as 
‘described above, 
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eMDS MASTER DISC STOP 


1. FUNCTION 


To stop Master Dise processing, 


2, PARAMETER CARD 


The parameter card format is as follows: 


Col. lito 4 Identification code: eMDS 
Col, 5 to 72 Not used 
Col. 73 to 80 Serial code if required. 


3. EXECUTION 


The printer makes a slew to the next page, then the program stops at address 
01D6. Pilot 0 is restarted by pressing RUN. 


4. MESSAGES 


Processing of the order causes, the following message to be printed: 
7601 x MASTER DISC STGP 


Processing halts at address 01D6. 
Pilot 0 is restarted by pressing RUN. 
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oDDP Disc DUMP 


1. FUNCTION 


To print the part of the file found on the specified volume, or to print the 
entire file. 

First the volume label is printed then the program file label is printed, 
then the program file is printed, 


2. SYSTEM UNITS REQUIRED 


The Dise Dump program uses the following peripherals. 
- adise unit on which the program file to be printed is located 


- adise unit for the SD, if the program file to be printed does not 
contain a eDDP program 


- aprinter. 


3. PARAMETER CARDS 


The Disc Dump program uses only an order card with the following format: 


Col. Lto 4 Order identification code: eDDP 


Col, 5& 6 Logical disc unit number (punched in column 6) of the 
unit on which the volume containing the file of programs. 
to be printed is installed; if this is the System Disc, 
punch SD. 
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Col. 7 = 0 if only cylinder 0 is to be dumped 


= ¥ if the entire program file is to be dumped including 
cylinder 0 


= 1 if only type 1 program are to be dumped. 


In this case, if columns 8 to 15 are not punched, 
printing begins with the first type 1 program in the 
program file index; otherwise, the program 
specified in columns 8 to 15 is dumped first. 

If columns 17 to 24 are blank, dumping ends with 
the last type 1 program; otherwise dumping ends 
with the program specified in columns 17 to 24. 

In this case, columns 16 to 25 should be blank. 


2 when only the subroutine library is to be dumped. 


In this case, if columns 8 to 13 are blank, 
dumping begins with the first subroutine speci- 
fied in the subroutine library; otherwise it begins 
with the subroutine specified in columns 8 to 13. 
If the area between columns 14 and 19 is blank, 
the library is dumped completely; otherwise 
dumping ends with the subroutine specified in 
this area. 


= 3 if only type 8 programs are to be dumped. 


In this case, the same rules apply to punches in 
columns 8 to 15 and 17 to 24 as stated for type 1 
programs; columns 16 to 25 are left blank if 
columns 8 to 15 or 17 to % are blank. If these 
areas contain the name of a program, punch "c" 
in columns 16 or 25 for a debugging program, or 
leave blank for a regular program. 


Col. 26 = if each program is to be dumped completely 


= 1 if only the indications in the program file index 
are to be dumped for each program requested. 
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Col. 27 to 72 Not used 
Col. 73 to 80 Serial code (if desired). 


DESCRIPTION AND EXECUTION 


The program is made up of a single segment located at memory address 
2048 (decimal). 


It must be remembered that an order card ean only be used to dump a 
single program file. 


CHECKS AND ERROR MESSAGES 


The program checks the operation of disc units and the validity of 
parameters punched in the order card. When an error is detected, it ig 
indicated by means of one of the following messages: 


0101 x D. UNIT N PERSISTENT ERROR 
Persistent read error on logical disc unit N. Program terminates 
feasibility condition: NO. 

0102 x D. UNIT N OUT OF ORDER 


Logical disc unit N signalled out of order. 

The program causes the printer to move the paper to the next page 
and halts at location 01DA. Pressing RUN retries the operation 
which caused the signal. If the signal repeats, the program termi- 
nates; feasibility condition: NO. 


0103 xD. UNIT N PERSISTENT ERROR 


Positioning error on logical disc unit N. 
Program terminates; feasibility condition: NO. 
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0104 x NO FILE PROGRAM ON ND. UNIT 


There is no program file in the volume on logical dise unit N. 
Program terminates; feasibility condition: NO. 


0105 x COLUMN NN OF ORDER CARD WRONG 


The order card area beginning at column nn was incorrectly 
punched. 
Program terminates; feasibility condition: NO. 


0106 x TIN... NC NOT FOUND 


No type T program named N ..N with debugging code C in the 
program file index. 


Program terminates; feasibility condition: NO. 
0107 x UNIT NIS NOT A SD 


Request for dumping of subroutine library from a volume on 
logical dise unit N which has no SD. 


EXAMPLE 


To dump all type 3 programs, beginnitg with the volume label and the program 
file label, of the volume installed on logical unit 2, starting with the 

first program file index and continuing through the program named 

FUSIONE 1, which is not a debugging program, the order card, which is 
linked to the others by the serial code ALFA, should have the following 
format: 


Col. Lto 4 eDDP 
Col. Sto 6 2 


Col. 7 3 
Col, 8tolS $....% 
Col, 16 ¥ 
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Col. 17 to 24 
Col. 25 
Col. 26 
Col. 27 to 72 
Col. 73 to 76 
Col. 77 to 80 


FUSIONE 1 
¥ 

B 

W...B 
ALFA 
B...8 
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eCMT COMMENT 


1. 


FUNCTION 


To print a comment line. 


ORDER CARD 


The order card has the following format: 
Col. lto 4 Identification code: e¢MT 
Col. 5 to 72 Comment 
Col. 73 to 80 Serial code (if desired) 


EXECUTION 


The comment is printed and Pilot 0 is initiated. 
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eHLT HALT 


1. FUNCTION 


To halt processing. 


2. ORDER CARD 


The order card has the following format: 
Col. tto 4 Identification code: oHLT 


Col. 5 to 72 Not used 
Col, 73 to 80 Serial code. 


3. EXECUTION 


On a HALT instruction, Pilot 1 stops at memory address 01D6. Pressing 
RUN restarts Pilot 0. 


246 


DISC OPERATING SYSTEM 


oSDG SYSTEM DISC GENERATE 


FUNCTION 


This program personalizes a System Disc, that is it adapts it toa 
determined configuration. The order eSDG will apply to 2 volume already 
containing a System Disc. 


The orders that must be carried out for the generation of a System Disc 
usually succeed each other in the following sequence: 


aND = assigns a serial number to a volume on which a System Dise 
will be recorded 


eFLW. = file label write 

eSPD = duplication of a System Dise from the source volume onto the 
volume to generate 

eSDG = adaptation of the new System Dise to the desired configuration. 

SYSTEM UNITS REQUIRED 


The program requires the following peripheral unit: 

- a disc unit containing the source System Disc 

- adise unit containing the System Disc to be generated 
- printer 


- card reader 
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The program requires one order card and several detail cards, 


ORDER CARD 


It has the following format: 


Col. 1lto 4 


Col. Sto 6 


Col 7to12 


Col, 13 to 72 
Col. 73 to 80 


DETAIL CARDS 


Identification code o SDG 


logical number (punched in column 6) of the disc 
unit which contains the System Disc to be generated 
or WD if the logical number has been punched in 
column 17 of the last eINT card read. 


Serial number of the volume mounted on the working 
unit ( if check is not desired) 
not used 


serial code if desired. 


These cards specify the configuration desired. There must be a minimum of 
five and a maximum of seven such cards, 


The following five cards must always be present : 


- RDC ~ reader compile 


- PRC - printer compile 


- psc 


dise compile 


- CDC ~ code compile 


- MCC - memory capacity compile 
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The other two are required when the relative peripherals are present: 


- TPC - tape compile 


- PNC - punch compile 


3.2.1. RDC card 


It specifies the type of the card reader used in the configuration and 
the connector number assigned to it. 


It has the following format: 


Col. Lto 4 
Col. Sto 6 


Col. 7 to 9 


Col. 10 to 80 


2.2.2, PRC card 


identification code ARDC 


reader type: 

- BL = CRZ10G CRZ120 
- $2 = tobe assigned 

- ¥83 = to be assigned 
- #4 = CRP100 


reader connection number (decimal) or blank if 
the reader has an integrated controller 


not used. 


It specifies the type of the printer and the connection number assigned 


to it. 


It has the following format: 


Col. Lto 4 
Col. Sto 6 


Identification code HPRC 
printer type: 


- $1 = Integrated printer (PRT 100, 110, 143, 
144, 146, 163, 166). 

-#2 = Buffered printer (PRT 118, 120, 125, 
130, 145, 147, 148, 149, 168, 169). 
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- BS 


- 4 = to be assigned 


Serial printer (PRT 1065), 


- $5 = to be assigned 


Col. Tto 9 printer connector number (decimal) or blank 
if the printer has an integrated controller. 


Col. 10 to 80 Not used. 
3.2.3. DSC card 


It specifies the type of the dise controller connected to the system, 
the number of the disc units involved and their connection numbers. 


It has the following format: 


Col, 1to 4 Identification code ASC 


Col. 5to 6 disc controller type: 
- ¥i = DSC130 
- $2 = to be assigned 
- #3 = to be assigned 
Col. 7to 8 number decimal dise units connected, from 1 to 


10 


Col. 9toll connection number (decimal) of the first disc 
unit connected 


. 
Col. 12 to 14 conection number (decimal) of other possible 


Col. 36 to 38 dise units 


Col. 39 to 80 Not used, 
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It specifies the type of tape controller connected to the system and the 
number of tape units involved. 


It has the following format : 


Col, 
Col. 


Col, 


Col, 


lto4 
5 to 6 


7 


8 to 80 


identification code BTPC 


tape controller type: 


WL = GUN STANDARD 7 
¥2 = GUN STANDARD 7/9 
B83 = to be assigned 

4 = to be assigned 

#5 = to be assigned 

6 = to be assigned 


number (decimal) of tape units connected, from 
1to8 


not used. 


If there are no tape units, the TPC card is not included. 


3.2.5. PNC card 


It specifies the type of punch used in the configuration and the 
connection number assigned to it. 


It has the following format: 


Col. 
Col, 


lto 4 
5to 6 


identification code BPNC 
punch type: | 


¥1 = CRPi00 
¥2 = CPZ101 
¥3 = CPZ103 
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Col, Tto 9 punch connection number (decimal) 
Col. 10 to 80 not used 


If there is no punch in the system, the PNC card is not included. 


3.2.6. CDC card 
It specifies the punch code used in the configuration. 
It has the following format: 


Col, 1lto 4 identification code BCDC 


Col. 5 punch code: 
- H = code Hollerith 
- B = code Bull 


Col. 6 to 80 not used. 


3.2.7. MCC card 


It specifies the memory maximum capacity provided for in the 
configuration. 
It has the following format: 


Col. 1lto 4 identification code KMCC 


Col. Sto 6 memory capacity: 


~ 08 = 8,192 location memory 
- 12 12, 288 location memory 
- 16 = 16,384 location memory 


Col. 7to 80 not used 
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3.2.8. END card for end of order 
This card must follow the detail cards; 


Col. 1lto 4 identification code KEND 
Col. 5 to 80 not used 


DESCRIPTION AND EXECUTION 


The program with decimal location address 2048 is made up of 57 segments. 
The first two segments make up the actual program and the other 55 are 
each subroutines; some of the subroutines will be inserted by the program 
cylinder zero of the System Disc to be generated, according to the current 
configuration, 


The 55 segments can be divided into three groups; first group for disc 


subroutines, second group for tape subroutines and third group for read 
and print subroutines. 


DISC _ SUBROUTINES 


segment 3 = DSC130 
segment 4 = to be assigned 
segment 5 = to be assigned 
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TAPE SUBROUTINES 


segment 6 = GUN STANDARD 7 

segment 7 = GUN STANDARD 7/9 \ 

segment 8 = to be assigned ) when configuration includes 
segment 9 = to be assigned \ a Hollerith code card 
segment 10 = to be assigned 5 reader, 

segment 11 = to be assigned ) 


segment 12 - 17= as segment 6 - 11 when configuration including a 
Bull code card reader. 


READ AND PRINT SUBROUTINES 


segment 18 = integrated reader (CRZ100, CR2Z120) 
integrated printer 
segment 19 = integrated reader (CRZ100, CRZ120) when 
buffered printer con- 
segment 20 = integrated reader (CRZ100, CRZ120) figu- 
serial printer ration 
segment 21 ~32 = to be assigned includes 
segment 33 = reader punch (CRP100) a Holle- 
integrated printer rith code 
segment 34 = reader punch (CRP100) card 
buffered printer reader 
segment 35 = reader punch (CRP100) 


serial printer 
segment 36 - 36 = to be assigned 


With a card reader (Bull code), segment 38 - 57 corresponding to segments 
18 - 37. 
It should be noted that the only difference between the magnetic tape subrou- 


tines for a configuration using a Hollerith reader and the magnetic tape 
subroutines using a Bull reader lies in their location address. 
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4002 x D. UNIT N OUT OF ORDER 


Unit number N indicates "OUT OF ORDER". The program makes 
a page change on the printer and halts at the address 01DA. 

By depressing RUN the operation which caused the message is 
restarted; if that message reappears the program stops and the 
feasibility condition is NO. 


4003 » D. UNIT N PERSISTENT ERROR 


Error in positioning on unit number N, The program stops and the 
feasibility condition is NO. 


4010 x NUMBER OF DISC UNIT WRONG 


The disc unit logical number specified in the eSDG card is wrong; 
the program stops and the feasibility condition is NO. 


4011 x NUMBER OF DETAIL CARDS WRONG 


Some of the detail cards which must be present (RDC, PRC, DSC, 
CDC, MCC) have not been read. 


The program stops and the feasibility condition is NO. 


4012 x DISC UNIT NOT AVAILABLE 


The serial number punched on the eSDG control card does not 
belong to the volume mounted on the working unit. 
The program stops and the feasibility condition is NO. 


4013 x DETAIL CARD WRONG 


An error has been detected in a detail card. The program stops and 
the feasibility condition is NO. 
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EXAMPLE 


A System Dise (mounted on logical unit 1) is to he adapted to a configuration 
provided with an 8,192 location memory and connected to a CRP100 that is 
used as a card reader punch (Hollerith code, a PRINTER300 and a disc 
subsystem DSS130. 


The following ecards must be punched: 
1. Order Card 


Col, 1to 4 eSDG 
Col. Sto 6 Ww 
Col. 7 to 80 not used. 


2. RDC detail card 
Col. 1lto 4 BRDC 
Col. Sto 6 }4 
Col. Tto 9 064 
Col. 10 to 80 not used. 


3. PRC detail card 
Col. lto 4 PRC 
Col. Sto 6 ¥1 
Col, 7 to 80 not used. 
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Col, lto 4 WDSc 
Cot. Sto 6 WL 

Col, 7to 8 02 

Col. 9toll 032 

Col. 12 to 14 033 

Col. 15 to 80 not used, 


PNC detail card 

Col. 1lto 4 ¥PNC 
Col. Sto 6 ¥1 

Col. Tto 9 064 
Col. 10 to 80 not used. 


CDC detail card 

Col. 1lto 4 KCDC 
Col. § H 

Col. 6 to 80 not used, 


MCC detail card 

Col. 1lto 4 ¥MCC 
Col. Sto 6 08 

Col. 7to 80 not used, 


END card for end of order 


Col. 1to 4 BEND 
Col. 5 to & Not used 
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oO 


eRST RESTART 


-1. FUNCTION 


The oRST order resumes program execution from a memorized check-point. 
The check-point is written into any standard file by means of the macro- 
instruction CHKP in the case of a tape or by means of the macro-instruction 
DCKP into a previously specified volume area, 


Before resuming program execution, the eRST order fills the memory and 
resets the I/O files on tape and on disc. 


2, SYSTEM UNITS REQUIRED 


The program requires the following peripherals for execution: *) 


-  adise unit that contains the System Disc or the Master Disc 


- as many disc units or tape units as are required by the program 
concerned 


-  acard reader 


- aprinter, Q; 


3. PARAMETER CARDS 


Two types of order cards are used depending on whether the check-point 
has been written on tape or on disc. 


DISC OPERATING SYSTEM 


Using the detail cards that specify the configuration desired the eSDG 
program modifies some of the source program areas contained in 
cylinder zero of the System Disc to be generated, is: 


a) it compiles three branches to the subroutines, that is two branches to 
the tape subroutines (addresses 0068 and 0074) and one branch to the 
read and print routine (address 006C) according to the punch code 
used in the configuration, 


b) it writes into the source program second segment some bits that 
specify the new configuration. 


e) in segments 2, 3, 5 and6 of the Source Program, it replaces the read 
and print subroutines the tape and disc subroutines by those that area 
indicated in the detail cards, via the 55 segments forming the program. 


d) it writes the new index of the cylinder zero into sectors 21 and 22. 
This index is constituted by records of 7 positions each; it ends with a 
character FF for end of table. The first two characters in each record 
indicate the length (binary) of the data contained on the cylinder; the 
next two characters represent the location address (binary) of this 
data. The last three cheracters stand for the address (decimal) of the 
sector in which the data is written. 


5. CHECKS AND ERROR MESSAGES 


After checks have been performed on the peripherals and the control cards, 
the program indicates the errors by means of the following messages: 


4001 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading, writing or checking on unit number 
N, The program stops and the feasibility condition is NO. 
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3.1. ORDER CARD FOR A DISC-ORIENTED 


It has the following format: 


Col. 1lto 4 identification code oRST 
Col. 5 to 12 program name 

Col. 13 to 18 six blank characters 
Col. 19 to 72 not used 


Col. 73 to 80 serial code, if any. 


3.2. ORDER CARD FOR A TAPE-ORIENTED CHECKPOINT 


Tt has the following format: 


Col. Lto 4 identification code oRST 


Col. 5 to 80 number of the checkpoint from which the program is 
to be restarted 


Col. 9 logical number of the tape unit containing the tape on 
which the checkpoint has been written 


Col, 10 code 0 for a tape with even parity check 
code P if it is written with odd parity check 


Cot. 11 code indicating the packing density; it may have the 
following values: 


800 bpi 
556 bpi 
200 bpi 


azo 
ill 


Col. 12 to 17 serial number of the tape containing the checkpoint. 
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Col. 18 tape-recording mode according to the following 
values:" 
7  - for seven track tape 
9  - for nine track tape 


Col. 19 to 72 not used 


Col. 73 to 80 serial code, if any. 


DESCRIPTION AND EXECUTION 


The program is made up of four segments; its location address is 2300 
(decimai). 


THE FIRST segment carries out the following functions: 


A. 


D. 


Checks the parameters contained in the order card. 


Searches for the checkpoint written on disc or tape, according to the 
order card, 


Loads, from tape or dise into memory, a series of data including the 
file table needed to carry out the checks on the files, 


Loads the second segment into memory. 


THE SECOND SEGMENT performs the following functions: 


A. 


Checks and resets the peripherals according to the data contained by 
the file table. This is done only for the standard files that were 
already open when the checkpoint was written. 


Loads into memory the third segment if the checkpoint has been 


written on tape or the fourth segment if the checkpoint has been written 
on disc. 
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THE THIRD SEGMENT carries out the following functions: 


A, Fills the memory from the program location address. It also fills 
the reserved areas concerning the program including the print and 
read areas. 


B. May call a user sequence, to check non standard files or to perform 
any other operation before the program is restarted. 


C. Initiates the program from the instruction that follows the macro- 
instruction which generated the checkpoint. 


The part of program which carries out these functions fills the read area 
and the print areas. 


The fourth segment has the same functions as the third one but for a dise 
oriented checkpoint instead of tape. 


It should be noted that the system configuration at the time when the program 
is restarted must be the same as when the checkpoint was written: the same 
logical numbers must be assigned to the disc or tape units in order to make 
sure that the program to be restarted will use the same volumes and the 
same peripherals, 


ERROR CHECKS AND MESSAGES 


The program performs a number of checks on the working of the units 
concerned and the validity of the parameters punched on the order card. 


The errors detected are indicated by means of the following messages: 


4501 x D. UNIT N PERSISTENT ERROR 


Persistent error in reading on the disc unit with logical number 
N. The program stops and the feasibility condition is NO. 
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4502 x D. UNIT N OUT OF ORDER 


The dise unit with logical number N is OUT OF ORDER. 

The program makes a page change on the printer and halts at the 
address O1DA, 

By depressing RUN the operation which caused the message is 
restarted, if the message reappears, the program stops and the 
feasibility condition is NO. 


4503 xD. UNIT N PERSISTENT ERROR 
Persistent error in positioningon the disc unit with logical number 
N. The program stops and the feasibility condition is NO. 

4504 x UNIT N NO STANDARD FILE 
Tape unit N contains a non standard file. 
Program stops; feasibility condition: NO. 

4505 x UNIT N PERSISTENT ERROR 
Persistent error in reading or writing on the tape unit with 
logical number N, Program stops; feasibility condition: NO. 

4506 x UNIT N OUT OF ORDER 


Tape unit N is OUT OF ORDER. 

If the out of order condition occurs after a rewind, the program 
halts at the address 01DA. If that condition occurs after a 

read or write instruction, the program stops at the address 02A6 
and the feasibility condition is NO. 


4507 x UNIT N PERSISTENT ERROR 


Error in positioning on tape unit N. 
Program stops at the address 02A6; feasibility condition: NO. 
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4508 x ORDER CARD COLUMN NN ERROR 


Error in one of the columns 9, 10, 11 or 18 of an order card used 
for a tape-oriented restart or columns 13-18 for a disc-oriented 
restart, 

The program stops and the feasibility condition is NO. 


4509 xCHKP-FILE NOT FOUND 
The System Dise contains no CHKP file. Program stops; 
feasibility condition : NO. 

4510 x CHKP-FILE NOT AVAILABLE 


The general CHKP file cannot be used. In case of special CHKP 
file, the error may result of a difference between the actual name 
of the file and the one indicated in the order card. 

The program stops and the feasibility condition is NO. 


4511 x» CHKP BLOCKS ARE INCORRECT 


The blocks written during the checkpoint do not exactly correspond 
to the part of the memory to be filled again. 
The program stops and the feasibility condition is NO. 


4512 D. UNIT N VOLUME M ... M ABSENT 


The serial;number of the volume contained in the file table (M...M) 
is not the same as the number of the volume mounted on unit N. 
The program stops and the feasibility condition is NO. 


4514 x UNIT N: VOLUME M ... M ABSENT 


The volume indicated in search for the checkpoint, and which is 
mounted on tape unit N, has a number other than the one punched 
in the order card. The program stops and the feasibility condition 
is NO. 
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4515 x UNIT N CHKP NNNN ABSENT 


The checkpoint required is not found on the tape indicated. 
The program stops and the feasibility condition is NO. 


4516 x D, UNIT N NOT AVAILABLE VOLUME 
The disc unit N does not contain a volume label or a file label 
corresponding to the labels found in the file table. A print out of 
the volume file label found in volume N is carried out before the 
error message. 
The program stops and the feasibility condition is NO. 

4599 x END RESTART DISC AS CHKP NNNN 


End of the restart program, 


EXAMPLE. 


TAPE-ORIENTED CHECKPOINT 


A program is to be restarted from checkpoint number 0033, 
The checkpoint has been written on the tape contained in tape unit 3 and 
described as follows: 


- 9 tracks 

~- density 800 bpi 

~ odd parity check 

- serial number 0A 7913. 


265 


DISC OPERATING SYSTEM 


The card to be punched must have the following format: 


Col. Lto 4 eRST 
Col. Sto 8 0033 


Col. 9 3 
Cot. 10 P 
Col. 11 L 
Col, 12 to 17 0A 7913 
Col. 18 9 


Col, 19 to 80 not punched. 


6.2. DISC-ORIENTED CHECKPOINT. 
The program PROVA is to be restarted from the last checkpoint written. 
The card to be punched must have the following format: 


Cot. lto 4 eRST 
Col. 5to 9 PROVA 
Col. 10 to 80 not punched. 


266 


DISC OPERATING SYSTEM 


eSGE SAMPLES GENERATE 


1. FUNCTIONS 


The eSGE program writes a sample file on one of the tapes of the system 
data are written on detail cards. Resulting files may be standard or 
non-standard, and blocks may or may not be numbered. If the file is to be 
standard with numbered tapes it is automatically closed by the program. 


If records with variable length are generated, writing of record lengths 
is left to the user. 


2. SYSTEM UNITS REQUIRED 


The program requires the following peripherals: 


~ a dise wit containing the System Disc 
- 2 printer 
- acard reader 


- a tape unit. 
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8. PARAMETER CARDS 


3.1. ORDER CARD 


It has the following format: 


Col, 1to 4 identification code eSGE 


Col. 5to 6 code indicating the logical number of the tape unit on 
which writing takes place; it can assume values ranging 
from #1 to #8. 


Col. .7 code indicating a even or odd parity checking: 
P = odd parity check 
O= even parity check 
Col. & code indicating the packing density; it can assume the 
following values: 
L = 800 bpi 
M = 556 bpi 
200 bpi 


N 


Col, 9 code indicating the format of data punched on detail 
cards; it can assume the following values: 


X ~ the detail cards contain hexadecimal data that can 
be accompanied by alphanumeric characters 
preceded by a character . (period). 

‘In this case, for every two characters punched 
on a card only one characters is written on tape. 
This format which enables writing every possible 
configuration of the code GECD, can only be used 
with 9 track tapes. 


% = the detail cards contain alphanumeric data, For 


each character punched on a card a character is 
written on tape. 
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Col. 10 to 14 Number of blocks to be reserved on the tape. Ifa 
standard file is desired and the tape is labelled, three 
blocks must be reserved. 


Col..15 to 72 not used 
Col. 73 to 80 Serial code, if any. 


DETAIL CARDS 


The detail cards contain the data to be written into the file. There are 
four types of detail card: 

Cards BLK containing the characters to be written 

Cards SBL for start of block 

Cards EBL for end of blocks 


ae cee cae ad 


Cards TPM for tape mark write. 

The detail card input sequence is as follows: 

SBL - BLK - BLK...... BLK - EBL ~ SBL- BLK~ BLK..... 
All detail cards must. be immediately followed by the card END. 
Each of these detail cards is described below: 

Card SBL 

It must be placed before all the BLK cards that make up one biock. 


Col. 1to 4 identification code #SBL 


Col. Sto 9 number of the block to be written. Not punched if no 
number ig assigned to the block 


Col. 10 to 80 not used, 
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Card BLE 


Col. 1to 4 identification code BBLK 


Col. 5to 6 Number of characters punched on the card and to be written 
on tape. This number may not be greater than 74 since 
columns 7 ~ 80 are reserved for the characters to be 
written. 


Col. 7 to 80 characters to be written. 


Card EBL_ 
It must come after all the BLK cards that make up one block. 


Col. 1Lto 4 identification code EBL 
Col. Sto 80 not used, 


Card TPM 
Writes a tape mark. 


Col. 1to 4 identification code STPM 
Col. Sto 80 not used. 


END CARD FOR END OF ORDER 


This card must come immediately after all the detail cards. It has the 
following format: 


Col. 1to 4 identification. code KEND 
Col. 5 code indicating the type of file closing: 
V = the file is closed by label EOV 
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¥F = the file is closed by writing of label EOF 

¥ = the file has already been closed by the detail cards. 
The program merely rewinds the tape. 

The program may directly close the file by writing 
the label EOV or EOF only when the tape has a 
standard label and the order card requires the 
reservation of two blocks or more, 

Otherwise the file must be closed by means of the 
detail cards and the program checks the presence 
of code B in column 5. 


Col. 6 to 80 not used. 


DESCRIPTION AND EXECUTION 


The program is made up of one segment and located at address 2300 
(decimal). It first checks the parameters contained in the order card; if 
no errors are detected it writes the file. In doind soit sets the tape to be 
written after the blocks to be reserved. When no block is to be reserved, 
the program rewinds the tape and carries out two erasures, 


Then the program reads, checks and prints out the detail cards while 
making up and writing the blocks, 


Once the END card has been read the program closes the file as required 
by the END card and rewinds the work tape. 


CHECKS AND ERROR MESSAGES 


The program checks the order card for its parameters. 


- Code indicating the tape unit on which writing takes place (col. 5 - 6) 
The program checks that one of the accepted values has been punched 
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- Code indicating even or odd parity check (col. 7). 
The program checks that one of the two values Qor P has been punched. 


- Code indicating the packing density (col. 8). 
The program checks that it has one of the accepted values. 


- Code indicating the format of the data contained in the detail cards 
(col. 9). The program checks that it has value X or B. 


The program checks the identification codes and the read sequence: 
(SBL - BLK - EBL) of the detail cards. 


In addition the program checks the card BLK for the number of characters 
to be written (col. 5 - 6) that is not greater than 74. The program also 
checks that column 5 of the END card contains one of the codes V, F, or 
¥ indicating to reserve two blocks or more. 

Otherwise the program checks that the second block is the beginning file 
label (HDR). 


Errors are indicated by means of the following messages: 


2301 x TAPE UNIT CODE ERROR 
The code indicating the tape to be written is wrong. 
Program stops at address 02A6; feasibility condition: NO. 
2302 # CHECK CODE ERROR 


The code indicating the type of check (even or odd parity check) 
is not correct. Program stops.at address 02A6; feasibility 
condition: NO. 


2303 x» DENSITY CODE ERROR 


The code indicating the packing density is not correct. The 
program stops at the address 02A6 and the feasibility condition 
is NO. 
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2304 x READING TYPE CODE ERROR 


The code indicating the format of the data punched on the detail 
cards is incorrect, 

The program stops at the address 02A6 and the feasibility 
condition is NO. 


2305 x LENGTH ERROR 


A BLK card indicates a greater number of characters to be 
written than 74. 

The program stops at the address 02A6 and the feagibility 
condition is NO. 


2306 x LAST LABEL CODE ERROR 


In the END card the code indicating the type of close is wrong. 
The program stops at the address 02A6 and the feasibility 
condition is NO. 


2308 x UNIT X : OUT OF ORDER 


The tape unit is OUT OF ORDER. 

If the out of order condition occurs after a rewind control the 
program halts at the address 01DA. The operator can put the tape 
unit back in order and depress RUN. 

If this condition occurs after a read or write instruction the 
program stops at the address 02A6 and the feasibility condition 

is NO. 

When it occurs during final rewinding, the program terminates 
normally. 


2309 x UNIT X : PERSISTENT ERROR 


Persistent error in reading or writing on the tape unit indicated. 
The program stops at the address 02A6 and the feasibility 
condition is NO. 


2310 x SEQUENCE ERROR IN SUB-ORDER CARDS 


The detail cards are out of sequence, The program stops at the 
address 02A6; feasibility condition: NO. 
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2311 x UNIT X ‘ END OF TAPE 


End of tape on tape unit X. The program rewinds the tape and 
stops at the address 02A6. 
The feasibility condition is NO. 


2312 x BLOCK LENGTH ERROR 


A block has more than 3584 characters for an 8 K memory or 
more than 4096 characters for a 12 K or 16 K memory. 

The program stops at the address 02A6. 

The feasibility condition is NO. 


2313 x HDR LABEL NOT FOUND 
Label HDR missing on the tape. 
The program continues normally. It stops at the address 02A6 
if the card END is not in column 5. 
The feasibility condition is NO. 
2307 x END OF SAMPLES GENERATE 


End of program. 


EXAMPLE 


A sample, file. is to be written on tape 1 with packing density 800 bpi and 
odd parity check; it is a nine-track tape. The data on cards are punched in 
hexadecimal and the file is standard with numbered blocks. 


Following are descriptions of the order card, the detail cards SBL and EBL 


concerning the first block, and the END card as the file is closed by label 
EOF. 


a4 


P 


Order Card 
Col, ito 4 
Col. Sto 6 
Col. 7 
Col. 8 
Col. 9 
Col. 10 to 14 
Col. 15 to 80 


Detail card SBL 


Col. ito 4 
Col. Sto 9 
Col, 10 to 80 


Detail card EBL 


Col, 
Col. 


END card 
Col. 
Col. 
Col, 


ito 4 
5 to 80 


ito 4 
5 
6 to 80 


eSGE 


00003 
not punched. 


¥SBL 
00001 


not punched 


BEBL 


not punched 


BEND 
F 


not punched. 
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eTDP TAPE DUMP 


This program prints out tape contents at given intervals. 
Printing may be in alphanumeric characters or in hexadecimal. 
Blocks cannot have more than 4096 characters. 


SYSTEM UNITS REQUIRED 


The program requires the following peripherals: 


- a dise unit containing the System Dise 
- 4 tape unit containing the tape to be dumped 


- a printer. 


PARAMETER CARDS 


Only an order card is required; it has the following format: 


Col. lto 4 identification code eTDP 


Col. Sto 6 logical number (punched in column 6) of the tape 
unit containing the tape to be dumped 


Col. 7 Code P indicating an odd parity check 
Code Oindicating an even parity check 
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Col. 


Col. 


Col. 


Col. 


Col. 


10 to 14 


15 to19 


20 to 72 


73 to 80 
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Code indicating the packing density. 


L = 800 bpi 
M = 556 bpi 
N = 200 bpi (x) 


code indicating the type of print out. 


X = hexadecimal 
& = alphanumeric 


sequence number of the first block to be printed out. 
In the absence of the number the print out starts from 
the first block written on the tape, that is from the 
label INT1 or VOL1 in the case of standard tapes. 


number of blocks to be printed out. In the absence 
of this number the print out ends with label EOV or 
EOF. 

Not used. 


Serial code, if any. 


DESCRIPTION AND EXECUTION 


The program is made up of one segment with location address 2300 
(decimal). It first checks the order card for its parameters. Though an 
ineorrect parameter might be found the check is still completed in order 
to indicate all the errors detected, 


(x) Using GUN 7/9 and 9 track tapes, only code L is available. 


Using GUN 7/9 and 7 track tapes, codes L, M, and N are available. 


Using GUN 7 codes M, N and L are available. In this case code L = 556 bpi. 


277 


DISC OPERATING SYSTEM 


If all parameters are correct the tape to be dumped is rewound and set 
before the first block to print out. 


Program stops after the number of blocks indicated in the order card or 
after the end label has been printed. Then the tape is rewound. 


In the print out the following line comes first: 


1901 x TAPE DUMP OF UNIT X FROM BLOCK NNNNN/BLOCKS : 
XXXXK 


with X standing for the name of the tape unit containing the tape to be 
dumped, NNNNN for the first block number and XXXXX for the number of 
blocks to print out. 


Prior to each block, a line is printed that contains the corrent block number 
and the number of characters in the block. 


If the last block number is not specified, the program stops after the 
print out of the end label EOV1 or EOF1. 
ERROR CHECKS AND MESSAGES 
The program performs formal checks on the codes punched on the order 
eard (columns 5 - 9), 
The following messages may be indicated: 
1901 x TAPE DUMP OF UNIT X FROM BLOCK NNNNN/BLOCKS XXXXX 
Print out heading 
1902 x END OF TAPE DUMP 


End of program 
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1903 x UNIT X PERSISTENT ERROR 


Persistent error in reading on tape. 
The tape is rewound and control is transferred to Pilot 0. 
Feasibility condition: YES. 


1904 x UNIT X : OUT OF ORDER 


The tape unit is out of order. 

If the out of order condition occurs after a rewind control, the 
program halts at the address 01DA. The operator can put the 
tape unit back in order and depress RUN. 

If this condition occurs after a read instruction, the program 
stops at the address 02A6 and the feasibility condition is NO. 
When it occurs during the final rewinding the program 
terminates normally. 


The messages that follow (1905 - 1908) concern errors detected in the 
order card, Each time the program will complete the reading of the card. 
Then it stops at the address 02A6 and the feasibility condition is NO, 
1905 x TAPE UNIT CODE ERROR 
The code (columns 5 - 6) indicating the logical number of the 
tape unit containing the tape to be dumped is not correct, 
1906 x CHECK CODE ERROR 
The code indicating an evenoor odd parity check (col. 7) is 
neither Ohor Pp, 
1907 x DENSITY CODE ERROR 
The code indicating the packing density (col. 8) is unknown 


1908 x DUMPING-TYPE CODE ERROR 


The code indicating the desired print out type {col. 9) is 
neither % nor X. 
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It is desired to print out, in hexadecimal, the tape contained on tape 
unit 3 which has been written with a packing density of 800 bpi. 


The following control card must be punched: 


Col, 


Col. 


Col, 


Col. 


Col 


lto 4 


Sto 6 


- 10 to 80 


eTDP 
BS 

P 

L 

x 


not punched. 
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eTRP TAPE RECORD BY RECORD PRINT 


1. 


FUNCTION 


This program prints the content of a data tape record by record. The records 
may be of fixed or variable length format. Records of variable length must 
contain the "record length" field. Tapes must have a standard organization: 
2 header labels followed by 1 tape mark,block numbers and a trailer label. 
The listing may be in alphanumeric or hexadecimal, It is not necessary to 
print the whole file. Certain areas may be selected by. means of parameters. 


SYSTEM UNITS REQUIRED 


This order requires the following peripherals: 


-  aprinter 
- adisc unit for the System Disc 


- a tape unit for the tape to be printed 


PARAMETER CARDS 


This Order uses one Order card only whose format is indicated below: 


Col. lito 4 eTRP 
Col. Sto 6 name of the unit on which the tape to be printed, is 
loaded. 


- WL = Work Tape 1 
- W2 = Work Tape 2 
- W3 = Work Tape 3 
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Col. 7 
Col. 8 
Col. 9 


Col. 10 to 14 


Col, 15to 19 


Tol. 20 to 23 


Col. 24 to 72 


Col. 73 to 76 


Col. 77 to 80 
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otherwise, the select number of the unit can be directly 
indicated in col. 6 


- P for even parity. 
- O for odd parity. 


code specifying the recording density 


K = 1600 bpi 
L= 800 bpi 
M = 556 bpi 
N= 200 bpi 


code specifying the printing mode 
X = hexadecimal print 
= alphanumeric print 


sequence number of the first block to be printed, with 
leading zeros. If not indicated, printing starts from the 
first block of the tape, that is from VOL1 label for 
standard tapes. 


number of the blocks to be printed, with leading zeros. 
If not indicated, printing ends with either end of volume 
or end of file. 


record length if the record is FL or UN, with leading 
zeros, 


¥6HB if the record is VL. 
not used 
optional ID code 


not used. 
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DESCRIPTION AND EXECUTION 


The program proceeds as follows: 


First, the order card is checked for any incorrect parameters. 


If parameters are correct, the tape to he printed is rewound and positioned 
infront of the first block to be printed. 


The program ends after printing either the number of blocks indicated in 
the order card, or the trailer label, At the end, the tape is rewound. 


If the number of the last block to be printed is not specified, the program 
ends by printing the trailer label EOV1 or EOF1. 


If the block number is specified in cols. 10-14, this number must be 
increased by 3 to account for 2 header labels and 1 TM. 


If a record is longer than one print line, printing will continue on the 
following line, 


In the case of hexadecimal print, the corresponding alphanumeric values 
will appear on the following line. 


CHECKS AND ERROR MESSAGES 


This order has no standard messages (no message number is indicated). 


*** PERSISTENT ERROR 


Read persistent error. By depressing START the operation is 
attempted five more times. Program execution stops at location 
01C 8; feasibility condition: NO. 
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*MTU N. X OUT OF ORDER 


Logical magnetic tape unit X out of order. Program execution stops 
at location 02A6; feasibility condition: NO. 


* PARAMETER ERROR: CORRECT AND BEGIN 
Parameter card is wrong. Character tarrow) shows the first 
position of the wrong field;correct the card and restart from the 
beginning, 

* END OF DUMP 
End of program, 


* END OF FILE 


The trailer label has been detected. 
EXAMPLE 


Print in hexadecimal the contents of the tape loaded on unit 4, written at 
800 bpi with records of fixed length of 107 chrts. each. Start printing 
from block 10. 

The following cards must be punched, 
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eTLW TAPE LABEL WRITE 


1. OBJECT 


This program writes beginning volume, end of volume, beginning file and 
end of file standard labels on any number of tapes. 


2. SYSTEM UNITS REQUIRED 


The program requires the following peripherals: 

- a dise unit containing the System Disc 

- areader 

= a printer 

- a number of tape units equal to the number of tapes that are to be 


labelled. 


3. PARAMETER CARDS 


3.1, ORDER CARD 
It has the following format: 


Col. 1lto 4 identification code eTLW 
Col. 5 to 72 not used 
Col. 73 to 80 serial code, if any. 
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3.2. DETAIL CARDS 


Each detail card contains the parameters that concern a tape to be labelled. 
It has the following format: 


Col. 1lto 4 identification code JTLW 
Col. 5 code 7 for 7-track tape 


code 9 for 9-track tape 


Col, 6to7 logical number (col. 7) of the tape unit containing the 
tape to be labelled, 


Col. 8 - code P indicating an odd parity check 
- code O indicating an even parity check 
Col. 9 code indicating the packing density: 
L = 800 bpi 
M = 556 bpi 
N = 200 bpi (x) 
Col. 10 - code V if an end of volume label EOVI is to be 
written 
- code F for an end of file EOF1 
Col. 11 to 16 volume serial number 
Col. 17 to 26 user's name 
Col. 27 to 43 file name 
(%) Using GUN 7/9 and 9-track tapes, only code L is available, 


Using GUN 7/9 and 7-track tapes, codes L, M and N are available, 
Using GUN 7, codes M, N, and L are available. In this case code L, = 556 bpi. 
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Col. 44 to 49 serial number of the file first volume 
Col. 50 to 53 volume sequence number in the file 


Col. 54 to 59 Creation date expressed in the form BYYDDD. 
In the absence of that date, the current date loaded 
by the control record eINT is indicated. 

The cancellation date is always the current date. 


Col. 60 to 80 Not used. 


END CARD FOR END OF ORDER 


That card must follow the detail cards: 


Col. ito 4 BEND 
Col. 5 to 80 Not used, 


DESCRIPTION AND EXECUTION 


The program is made up of one segment at location address 2300 (decimal) 
It first reads and checks the first detail card, 


If the parameters are correct, the program passes on to tape number 
labelling: it rewinds the tape, carries out two successive erasures and 


then writes the labels and the tape marks. 


Though an incorrect parameter.may be found, the check is still completed 
in order to indicate all the errors detected. 


If a detail ecard contains an error the corresponding tape is not labelled. 
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The program also reads the next detail card and writes the labels on the 
tape concerned, except when the identification code contained in the detail 
card has been detected as wrong (See message 1801). 

The program terminates after reading of the END card. 

Each tape then contains the following labels and tape marks: 

- beginning volume label VOL1 or INT1 for 7-track tapes 

- beginning file label HDR1 


- two tape marks 


- end of volume EOVI or end of file label EOF1 according to the option 
found in the detail card 


- one or two tape marks according to whether the preceding label is 
EOVI1 or EOF1. 


If incorrect detail ecards have been found and the corresponding tapes have 
not been labelled the program terminates and the feasibility condition is NO. 


The labelled tapes are rewound. 


CHECKS AND ERROR MESSAGES 


The program checks the detail cards for the parameters required in 
columns 5 - 10. It also checks that the date is expressed in numeric 
characters, 


Errors are indicated by means of the following messages: 
1801 x SUB-ORDER CARD NOT ACCEPTED 
Detail cards wrong. The program has read acard that contains 
neither BTLW nor END in the first columns. The tape is not 


labelled. The program stops at the address 02A6 and the feasibility 
condition is NO. 
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1802 x TRACKS NUMBER ERROR 


The track number is wrong (column 5 contains neither 7 nor 9). 
The tape is not labelled and the feasibility condition is NO. 
1803 x TAPE UNIT CODE ERROR’ 


The code indicating the tape unit containing the tape to be labelled 
is unknown, 


The tape is not labelled and the feasibility condition is NO. 
1804 x» CHECK CODE ERROR 


The code indicating even parity check or odd check is incorrect 

(column 8 contains neither P nor 0). 

The tape is not labelled and the feasibility condition is NO. 
1805 x DENSITY CODE ERROR 


The code indicating the packing density is not correct (column 9 

contains neither L, M, nor N). 

The tape is not labelled and the feasibility condition is NO. 
1806 x LAST LABEL CODE ERROR 


The code indicating the type of the end label is neither V nor F 
in column 10. 
The tape is not labelled and the feasibility condition is NO. 


1807 x DATE CODE ERROR 


The date is expressed in non-numeric characters. 
The tape is not labelled and the feasibility condition is NO. 


1808 x UNIT X : OUT OF ORDER 
The tape unit is out of order. If the out of order condition occurs 


after a rewind control the program halts at the address 01DA, 
The operator can put the tape unit back in order and depress RUN. 
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If this condition occurs after a read or write instruction the 
program stops at the address 02A6 and the feasibility condition is 
NO. 

When it occurs during the final rewinding the program terminates 
normally. 


1809 x UNIT X : PERSISTENT ERROR 


Persistent error in writing. 
The program stops at the address 02A6 and the feasibility condition 
is NO. 


1810 x END OF TAPE LABEL WRITE 


End of program. 
EXAMPLE 
Tapes 1 and 2 are to be labelled. Labels are to be written with packing 
density 800 bpi and odd parity check. 
In both tapes the end of file label must be written. 
The number labelling date is the current date. 
The following cards must be punched: 

Control card 
Col. 1to 4 eTLW 


Col. 5to 80 not punched, 
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First detail card TLW 


Col, 
Col. 
Col, 
Col, 
Col, 
Col. 
Col. 
Col. 
Col. 
Col. 
Col. 
Col, 


1lto 4 
5 

6to 7 
8 

9 
10 

11 to 16 
17 to 26 
27 to 43 
44 to 49 
50 to 53 
54 to 80 


BTLW 

9 

pL 

P 

L 

F 

0A1251 
OGE UDMS 


SOFTWARE DISTR. 


0A1251 
0001 


not used, 


Second detail card TLW 


Col, 
Col. 
Col. 
Col. 
Col. 


Col, 
Col. 
Col. 


lto 4 


. 11 to 16 


17 to 26 
27 to 43 
44 to 49 


¥TLW 

9 

K2 

Pp 

L 

F 

0A1205 
OGE UDMS 
SERVIZIO 
0A1205 
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Col. 50 to 53 0001 


Col. 54 to 80 not used. 


END card 


Col. 1to 4 ¥END 
Col. 5 to 80 not punched, 
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eTDC TAPE DUPLICATE 


1. PURPOSE 


This program is designed to duplicate any tape, whether it contains 


standard or non-standard files or programs (System Tape, Library Tape or 
Master Tape). 


2. SYSTEM UTILIZATION 


The program uses the following peripheral units: 


- Card reader 


Oo - Printer 


- Tape unit on which tape to be duplicated is mounted 
- Tape unit on which the tape to be written is mounted 


- Tape unit for the System Tape. 


Pf 3. PARAMETER CARDS 


The program requires a single order card with the following format: 


Col. 1to 4 Identification code: eTDC 
Col. Sandé File type code of the tape to be duplicated: 


-  4P if the tape to be duplicated contains programs 
(ST, LT or MT) 
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- D&S if the tape to be duplicated contains data with 
a standard format 


- DWN if the tape to be duplicated contains data 
with a non-standard format. 


Col, Vand 8 Code identifying the tape to be duplicated. 
It may have one of the following values: 


- 1 through #8 to indicate the logical numbers of 
the tape units. 


Col. 9 Code specifying the type of check for the tape to be 
duplicated: 


-  P to indicate an odd parity check 


~- Oto indicate an even parity check. 


Col, 10 Code specifying the recording density for the tape to 
. be duplicated. It may have one of the following values(x): 


-  L to indicate 800 bits per inch (bpi) 
- M to indicate 556 bits per inch (bpi) 
- N to indicate 200 bits per inch (bpi). 


Col. 11 to 16 Serial number of the tape to be duplicated. If no 
check required, these columns are left blank. 


Col. 17 and 18} 
Col. 19 

col, 20 

Col. 21 fo 26 


As for columns 7 through 16, but for the tape to be 
written, 


(x) Using a 7/9 track controller and 9-track tapes, only code L is accepted. 
Using a 7/9 track controller and 7-track tapes, codes L, M and N are accepted., 
Using a 7 track controller, codes L, M and N are accepted. In this case 
code L = 556 bpi, 
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Col, 28 to 44 


Col. 45 to 50 


Col, 51 to 53 


Col. 54 to 58 
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Code C if the file contained in the tape to be 
duplicated must be recorded next to a file 
already existing on the tape to be written. 


- Otherwise, leave blank. 


It should be noted that code C can only be used 
if code DS is punched tn columns 5 and 6. 


Name of the file if this is to be changed on the tape 

to be written. 

Otherwise, leave blank. 

The name of the file can be changed on the tape to 

be written only if the file contains standard-format 
data and the file to be duplicated is not to be recorded 
next to a file already existing on the tape to be 
written. (Code DS in columns 5 and 6, and code # 

in column 27). 


Serial number of the file if this is to be changed on 
the tape to be written. 

Otherwise, leave blank. 

The restrictions are the same as for the file name 
{col, 28 through 44). 

Number of tape retention days if the purge date is not 
to be the same as the writing date (day's date). 
Otherwise, leave blank. 

The dates in the HDR1 label are updated only if 
code DS is punched in columns 5 and 6 and code J 
in column 27. 


Number of blocks, starting from the first, which 
are not to be reproduced from the tape to be read. 
If the duplication is to be made starting from the 
first block, leave these columns blank. 
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Col. 59-63 number of blocks to be retained on the tape on which 
recording is effected. 
Nothing is punched if no block is to be retained. In this 
case the program effects two deletions. 
The data punched in columns 54 ~ 63 ts considered in 
the case of non-standard tapes only (code DN in column 
5 - 6) 


Col. 64 - code N, if the blocks have not been initialized 
- blank, if they have been, 


This option is valid only if code C is punched in column 
2t 


Col. 65 -code V, if the output tape is to be closed with the label 
EOV 
- any code, other than V, to close the tape with label 
EOF. 
Col, 66-72 not used 


Col. 73 - 80 serial code (optional). 
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PROGRAM DESCRIPTION AND EXECUTION 


The program is made up of two segments. Initially, it checks the order 
card parameters and, if no error is detected, proceeds to duplicate the 
tape to be read. Since either the whole or only part of the tape may need 
to be duplicated, the program first positions the two tapes and then carries 
out the duplication as requested in the order card. 

If the input tape contains check~points, these are not written. 


CHECKS AND ERROR MESSAGES 


The checks performed on the peripheral units and on the contents of the 
order card may result in the print out of one or more of the following 
messages: 


2501 x UNIT X - PERSISTENT ERROR 


Persistent reading or writing error on the unit indicated. 
The program halts at address 02A6. Feasibility condition: NO. 


2502 x UNIT X - OUT OF ORDER 


Unit out of order. If the out-of-order condition occurs after a 
rewind order, the program stops at a HLT at address O1DA,. 

The operator may reset the unit and press START. 

If this condition occurs after a read or write instruction, the 
program halts at address 02A6 and the feasibility condition is set 
to: NO. 


2504 x FILE TYPE CODE ERROR 


Error in the file type code (cols. 5 and 6). The program halts at 
address 02A6, 
Feasibility condition: NO. 
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2505 x INPUT TAPE CODE ERROR 


Error in the code identifying the tape to be duplicated (cols. 7 and 
8). 

The program halts at address 02A6. 

Feasibility condition: NO, 


2506 x INPUT TAPE CHECK CODE ERROR 


The code indicating the type of check to be made on the tape 
to be duplicated is invalid (col. 9). 

The program halts at address 02A6, 

Feasibility condition: NO. 


2507 x INPUT TAPE DENSITY CODE ERROR 


The code indicating the recording density for the tape to be 
duplicated is invalid (col, 10). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2508 x INPUT TAPE SERIAL NUMBER XXXXXX NOT EXACT 


YYYYYY EXACT 


The serial number of the tape to be duplicated is incorrect 
(cols, 11 through 16). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2509 x OUTPUT TAPE CODE ERROR 


The code identifying the tape to be duplicated is invalid (cols. 17 
and 18. 

The program halts at address 02A6. 

Feasibility condition: NO. 


2510 x OUTPUT TAPE CHECK CODE ERROR 


The code indicating the type of checks to be made on the tape to be 
written is invalid (col. 19). The program halts at address 02A6. 
Feasibility condition: NO. 
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2511 x OUTPUT CHECK TAPE DENSITY CODE ERROR 


The code indicating the recording density for the tape to be 
written is invalid (col. 20). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2512 x OUTPUT TAPE SERIAL NUMBER XXXXXX NOT EXACT 


YYYYYY EXACT 


The serial number of the tape to be written is incorrect (cols. 21 
through 26). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2513 x COMPLEMENT CODE ERROR 


The code punched in column 27 is invalid. 
The program halts at address 02A6. 
Feasibility condition: NO. 


2514 x RETENTION PERIOD ERROR 


The code specifying the retention period is invalid (cols. 46 
through 48). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2515 x INPUT TAPE BLOCK NUMBER ERROR 


The code indicating the number of blocks that are not to be 
written is invalid (cols. 49 through 53). 

The program halts at address 02A6. 

Feasibility condition: NO. 


2516 x OUTPUT TAPE BLOCK NUMBER ERROR 


The code indicating the number of blocks to be retained on the tape 
to be written is invalid (cols. 54 through 58). 
The program halts at address 02A6. Feasibility condition: NO. 
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2517 x UNIT N : NON-STANDARD FILE 


The 


unit specified has a non-standard file. The program halts at 


address 02A6. 
Feasibility condition: NO. 


2518 x END OF REEL 


End 


of the tape being written. 


When this message is printed out, one or the other of the two 
following conditions exists: 


a) 


b) 


The 


duplication has been completed: in this case, the program comes 
to a standard halt, 
Feasibility condition: YES. . 


duplication has not been completed: in this case, the program 
halts at address 02A6 and the feasibility condition is set to 
No. 


tape being written is closed in the following mamer: 
if the tape contains programs, it is closed with a Tape Mark 
and a label composed of 28 exclamation mark characters(!). 


if the tape contains data with a standard format, it is closed 
with a tape mark and an EOF label in which the block count 
field is incorrect. 


if the tape contains date with a non~standard format, it is 
closed with a Tape Mark. 


2599 x END OF TAPE DUPLICATE 


End 


of the program. The order has been executed correctly. 
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EXAMPLE 


A file containing standard-format data (written with odd parity check and 
with a recording density of 800 bits per inch on a volume with the serial 
number 000015, and mounted on a tape unit having the logical number 2) is to 
be duplicated on another tape with the same type of check and with the same 
recording density, having the serial number 000024 and mounted on the tape 
unit with the logical number 3. 


The whole of the tape is to be duplicated and nothing is to be added; the 
serial number and the name of the file are not to be changed; the purge 
date is to be the day's date; all the blocks on the tape to be read should 

be duplicated but none of those which may be found on the tape to be written 
should be retained. 


The following order card will be punched: 


Col. ito 4 eTDC 
Col. 5 to 6 DS 
Col. 7to & 2 
Col. 9 Pp 

Col. 10 L 
Col. 11 to16 000015 
Col. 17 and18 63 
Col. 19 P 
Col. 20 L 

Col, 21 to 26 000024 
Col, 27 to 80 Not used. 
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eDFG DIAGNOSTIC FILE GENERATE 


1. FUNCTIONS 


The purpose of this program is to write on cylinders 98 - 99 of any volume 
a data file to be used by the diagnostic programs. 


2. SYSTEM UNITS REQUIRED 


The program requires the use of the following peripherals: 


- adise unit on which an initialized disc has been mounted on the 
basic system disc 


- acard reader 
= @ printer 


- another disc unit when the diagnostic file disc is not the basic disc. 


3. PARAMETER CARDS 


This program requires only one order card with the following format: 
Col. lto 4 Identification code: eDFG 


Col. 5106 May contain one of the following values: 
- SD, if the diagnostic file disc is the System Dise 
- WD, if the diagnostic file disc is the Work Disc, 


~ én, where n is the logical number (from 0 - 9) 
of the diagnostic file disc. 
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Col, 7to 72 Not used 


Col. 73 to 80 Serial code if required. 


DESCRIPTION AND EXECUTION 


The program consists of a single segment at address 2048 (decimal). 


The program first checks that the diagnostic file label has been written 
on the receiver disc, specified by the order eF LW. 


All the headers of cylinder 0 are then checked against the contents of the 
memory. 


The following headers are also checked: 


00200 
00600 
00700 
00800 
00900 
01000 
01400 
02400 
04400 
07000 
08400 
10000 
10200 
10400 
16400 


If this check is not complete, the generation of the diagnostic data file 

is interm pted. 

When the receiver disc is not the System Disc, the order eDFG is executed, 
This implies that the order elND has already been executed. This order 
writes the headers and duplicates cylinder 0. 
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The program then uses cylinders 98 and 99 to write specific character 
configurations to be used by the diagnostic program. 


CHECKS AND ERROR MESSAGES 


The program checks the disc unit involved and the validity of the order card. 
Any error causes one of the following messages to be printed: 


4101 x D. UNIT N PERSISTENT ERROR 


A persistent read, write or check error has been found on the 
unit with logical number N. 

The program stops. 

Feasibility condition: NO. 


4102 x D. UNIT N OUT OF ORDER 


Disc unit with logical number N has been found out of order. 

The program slews the paper on printer to the next page, and 
comes to a halt at address 01DA. 

Pressing RUN retries the operation that has caused the Message. 
If the message is repeated, the program stops. 

Feasibility condition: NO. 


4103 x D, UNIT N PERSISTENT ERROR 


A persistent positioning error has been encountered on disc unit 
with logical number N. 

The program stops. 

Feasibility condition: NO. 


4104 x OUTPUT D, UNIT NUMBER ERROR 


The number of the diagnostic file dise unit as specified in the 
order card is incorrected. 

The program stops. 

Feasibility condition’ NO. 
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4105 x TRACK XXXXX NOT AVAILABLE 
One of the checks denotes lack of headers listed above. 
The program stops. 
Feasibility condition: NO. 

4106 x DIAGNOSTIC FILE NOT FOUND 


Check denotes lack of diagnostic file lable. 
The program stops. Feasibility condition: NO. 


4199 x END OF DIAGNOSTIC FILE GENERATE 


Denotes the end of diagnostic file generation. 
Control is transferred to the Operating System Pilot. 


EXAMPLE 

The diagnostic data file is to be written on a volume defined as Work Disc 
in col. 17 of order e@INT. 

The order card must be punched in the following way: 


Col. Lto 4 eDFG 
Col. 5to 6 wD 
Col. 7 to 80 Not used. 
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eVLC VOLUME LABEL CHANGE 


1. 


FUNCTION 


To change the volume label and/or the volume name on a disc pack, 


SYSTEM UNITS REQUIRED: 


- A dise unit for the System Disc 
- A printer 


- Additional disc if its label is to be changed. 
PARAMETER CARDS 


The format of the order card is: 


Col. Lto 4 eVLC 

Col. 5 Logical unit number of the dise to be changed 
Col. 6 to1l New volume label 

Col. 12 to 21 New volume name 

Col. 22 to 72 Not used 

Col. 73 to 76 Serial code (optional) 

Col. 77 to 80 Not used 
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DESCRIPTION AND EXECUTION 


This program is made up of a single segment stored at memory location 
1800 (decimal), 


The program performs the requested changes and prints out the following 
messages 


LOGICAL UNIT NUMBER N 
OLD VOLUME LABEL XXXXXX OLD VOLUME NAME XXXXKKKXKXK 
NEW VOLUME LABEL YYYYYY NEW VOLUME NAME YYYYYYYYYY 


Each file label is updated to reflect the change if the volume order number 
is equal to 0001 (positions 28 to 31 of HDR label). 


CHECKS AND ERROR MESSAGES 


6901 * D. UNIT X POSITIONING ERROR 
6902 * D. UNIT X OUT OF ORDER 
6903 * D. UNIT X PERSISTENT ERROR 


Program execution terminates. Feasibility condition: NO, 
6910 * ORDER CARD COLUMN 5 ERROR 


The logical unit number is not between 0 and 9. 
Program execution terminates. Feasibility condition: NO. 


6950 * WARNING - FILE TABLE NOT UPDATED 
Following a dise error, signalled by messages 6901-6902-6903, the 


file labels have not been modified. Program execution terminates; 
feasibility condition: NO. 
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6998 * VOLUME LABEL CHANGE FAILED 


This message is printed after the messages 6901 - 6902 - 6903 - 6910. 
Program execution terminates; feasibility condition: NO, 


6999 * VOLUME LABEL ENDED 


End of program. 
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APPENDIX A. PROCESSING THE LBC CARDS 


A.l. FILE OPENING 


Before a file on tape or on disc is processed, it must be opened, that is it 
must be checked and set. 


The checks have a double purpose: 


In the case of an input file they guarantee its identification. If the file is 
being written, they prevent erasure of valid information. The checks can 
apply to the file name, the writing date, the cancellation date, the file serial 
number and the sequence of the volumes making up one file. 

Some of these checks are automatic and some are plicitly required by the 
LBC card. 


The opening of a file is carried out by the macro-instructions OPEN and 
NEXT described in the APS Il Language Manual. The macro-instructions 
check the data stored in the file table against the information contained in 
the file label. 


The file table is made up of all the parameters that are necessary to open 
and control the files concerned in a program. It built up by the compiler 
APS II which retrieves data from the FILE instructions and reserves the 
locations which are to contain the data supplied by the parameter cards (LBC 
cards). 


The opening of a file implies the compiling of an LBC card that contains the 
data from which the file label checks must be performed and the storing of 
these data into the program file table. Such storing can be carried out at 
three different times: 
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a. when the program is written on the Library Disc. 
b. when the program is written on the Master Disc. 
¢. when the program is initiated, 
The following orders apply to the LBC cards; 

@LDU, oMDG, ePRL and eLPC. 


Each time one of these orders applies to an LBC card it transfers into the 

file table only the data that have been written on that card and leaves unchanged 
in the table the data not specified in the card, 

In the same way the LBC card may be used to modify a single data in the 

file table. 

The next paragraphs describe the file table relative to files on tape/dise 

the LBC card format and the card processing mode. 


A.2, LBC CARD FORMAT 


Each leader card contains the parameters relative to a given file. It has 
the following format: 

Col. 1to 4 card code, HLBC (Label Control) 

Col. 5to12 program name relative to the file to be opened 


Col. 13 to 18 file internal name used within the program in the FILE 
instruction and the processing instructions referring to 
the file 


Col, 19 to 30 file external name written on label HDR 
Col. 31 to 36 file serial number 


Col. 37 to 42 ¥YYDDD representing the file generation date. This date 
may also be indicated indirectly with reference to the 
area reserved for the user by the Operating System. 
Depending on the values contained in column 42 (from 0 

. to 5) the generation data source is as follows: 
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Col. 44 


Col. 45 


Col. 46 


Col. 47 


Col. 48 


Col. 49 
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~ from locations 40 - 45 
- from locations 52 - 57 
~ from locations 58 - 63 
from locations 64 - 69 
- from locations 70 - 75 
- from locations 76 - 81 


aAkwONDH Oo 
1 


number of the unit on which the volume containing the file . 
or the first part of the file is mounted 


number of the alternate unit used for sequential processing 
of a multivolume file. If the file is always read by the same 
unit the number indicated in column 43 is repeated. If the 
is constituted by a single volume column 43 ig not punched 


file external name check option; the option may be: 


Y - if check is desired 
N - if check is not desired 


In the case of files on disc, the check is automatic and 
column 45 is not used 


file serial number check option: 


Y - if check is desired 
N - if check is not desired 


volume sequence check option for the processing of a 
multivolume sequential file. 
The option is ¥ or N. 


file generation date check option (Y or N) 


processing option (Y or N) when file is to be processed 
ag an absent file. This option is only valid with input 
files. If itis Y, all the operations relative to the file 
are cancelled, 
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Col. 50 print out option expressed as the preceding one. If the 
option is Y,.the program which opens the file prints out 
the HDR label. When the check detects an error, the 
program prints out a part of the file table. 


Col. 51 file packing density. It can assume one of the following 
values: 


800 bpi 
556 bpi 
= 200 bpi 


L 
M 
N 
Column 51 is not used for file on disc. 


Col, 52 to 80 not used. 


The dates contained in the user's area are memorized by means of the 
orders eINT, oPRL, eMDG. 


The file serial number and the generation date are indicated only when it 
is desired to make sure that they match with the information written on HDR 
label, that is when the relative options (col. 46 and 48) are specifiedas Y. 


The parameters found in columns 43 - 44 are also indicated in the 
instruction FILE. They are optional in the leader card by when they are 
present they take precedence over the parameters contained in the 
instruction FILE. 


A.3. DESCRIPTION OF THE TABLE FOR FILES ON TAPE 


For each file on tape the following characters are reserved in the file table: 


Col. 1 code indicating the type of the file; it can assume the 
values: 


00 when the file is constituted by FL or UN records 
01 when the file is constituted by VL records 
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Col. 
Col. 


Col. 


Cot. 


Col, 
Col. 


3to 6 
7 to 23 


. 24 to 29 
. 30 to 33 
. 34 to 27 
. 38 to 43 
. 44 to 49 
- 50 to 55 


56 
57 to 62 


63 to 68 


69 


70 to 85 
86 
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number of characters reserved for the file in the file 
table: 94 (decimal) or 5E (hexadecimal). 

HORI 

reserved for the file external name read on LBC card 
reserved for the file serial number read on LEC card 
reserved for the volume sequence number in the file 
File sequence number: 0001 

reserved for the first volume serial number in the file 
reserved for the file generation date read on LBC card 


file retention period (parameter RP) contained in the 
FILE instruction or decimal zeros when parameter RP is 
not present, 

The cancellation date is calculated in that area when the 
program is initiated, 


working location 


file internal name taken from FILE instruction. 
After the opening of the file these locations are used to 
count the blocks. 


check options corresponding to the columns 45 - 50 of the 
LEC card, 
The compiler previously supposes options YYYYNY. 


Number of the alternate unit. 


Reserved for the parameters of the tape subroutine. 


Code indicating the description of the file: 


00 = standard file with numbered blocks 

01 = standard file with non numbered blocks 

80 = non standard file with numbered blocks 

81 = non standard file with non numbered blocks 
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A.4, 


87 to 88 
89 to 90 
91 to 94 
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length of the record area (WA) 
address of the record area 


working storage. 


DESCRIPTION OF THE FILE TABLE FOR FILES ON DISC 


The description of the file table for files on disc remains valid only until 
the macro-instruction OPEN is executed. 


The following characters are reserved in the file table for each file on disc: 


Col, 


Col. 


Col. 


Col, 


Cal. 


1 


3to 4 


5to 6 


Tto18 


code indicating the type of file processing: 


10 = sequential processing with FL or UN records 
11 = sequential processing with VL records 

20 = random processing 

80 = mixed processing with FL or UN records 

31 = mixed processing with VL records 


length of the parameters relative to the file. This length 
equals 100 characters for sequential files and all monovo- 
lume files. For random or mixed multivolume files this 
length is calculated as follows: 

100+10n 

with n standing for the number of volumes making up 

the file 


end of file/volume condition check subroutine address 
(instruction file parameter EV) 


FA area address. Binary zeros if FA has not been specified 


reserved for the file external name read on the LBC ecard 
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Col. 19 to 20 DA area address, Binary Zeros if DA has not been specified. 
Col. 21 KA area length. Binary zero if KA has not been specified. 
Col. 22 to 23 KA area address. Binary zeros if KA has not been specified. 


Col. 24 to 29 Reserved for the file serial number read on the LBC card. 
Col. 30 to 33 Reserved for the volume sequence number in the file. 

Col. 34 to 35 RA area address, Binary zeros if RA has not been specified. 
Col. 36 to 37 Page length decimal expressed in number of sectors. 

Col. 38 to 43 Working loeations. 

Col, 44 to 49 Reserved for the file generation date read on the LBC card. 
Col. 50 to 55 File retention period (parameter RP in the File instruction). 
Decimal zeros if RP has not been specified. 

When the program is initiated the retention date will be 


caleulated inside these locations. 


Col. 56 Reserved for a code that can assume one of the following 
values: 


1 ~ file maintenance 


0 = no file maittenance 
Col. 57 to 62 File internal name taken out from the FILE instruction 
Col. 63 Work location 


Col. 64 to 68 Check options corresponding to the columns 46 ~ 50 of 
the LBC ecard. The compiler APS supposes options YYYiTY 
when generating the file table. 


Col, 69 Alternate unit number, or value of parameter FE if 
processing is random or mixed. 
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Col. 70 to 85 reserved for the disc subroutine parameters 
Col. 86 code indicating the type of file: 
8S = sequential file 


R 


“ 


random file 


Col. 87to 88 WA area length (binary), Zero if WA has not been 
specified, 


Col. 89to 90 | WA area address (binary). Zero if WA ‘has not been 
specified. 


Col. 91 t0 100 Work area. 


With random/mixt multivolume files ten supplementary locations 
containing the following information expressed in packed characters are 
reserved for each volume: 


5 characters ~ overflow area first sector address 

5 characters - overflow area first external sector address 
5 characters — overflow area first free sector address 

5 characters - file label address. 


PROCESSING OF LBC CARDS 


All the orders that apply to LBC cards carry out the following functions: 


1, Check the program name against the name in columns 5 - 12 


2. Search in the file table, for the element relative to the file whose name 
is indicated in columns 13 - 18 


3. Store into the file table the file external name found in columns 19 - 30 


4, Store into the file table the file serial number found in columns 31 - 36, 
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5. Perform a formal check on the date written in columns 87 - 42. 
This date is expressed in one of the following forma: 


a. i1character / and 5 numeric characters 
b. 5S characters # and 1 numeric character ranging from 0 to 5. 


6. Store the date in the file table. If the table is expressed as under 5.b 
the orders eLDU and oMDG store the code instead of the actual date. 
The actual date will be taken from the user's area and stored in the 
file table when the order ePRL (or Monitor) is iasued. 


7. Calculate the cancellation date by means of the order ePRL (or 
Monitor). 


8. Perform a formal check on the number specifying the primary unit. 
This number must range from 0 to 9 in the case of a file on disc and 
from 1 to 8 in the case of a file on tape. 


9. Store this number into the file table. 

10, Perform a formal check on the number apecifying the alternate unit. 
That number must be expressed as the preceding one. When the file 
ig written on dise the check is performed only if processing is 
sequential. 

11. Store this number in the file table. 


12, Perform a formal check on the options expressed in columns 45 - 50. 
Column 45 is checked only if the file is written on tape. 


13. Store those options in the file table. 


14, Perform a formal check on the code indicating the packing density (col, 
51). This code must have the following values: LM N. 


15, Store this code into the file table. 


It should be noted that only the data actually written in the LBC card are 
stored in the file table. When a data is not found on the card, the corresponding 
data in the file table will not be modified. 
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APPENDIX B. PILOT ZERO CARD FORMAT 


The Pilot 0 initialization program (see. sub-paragraph 4.2.1., page 27) is 
punched in pure hexadecimal on one card. Its format is as follows: 


a) For systems using Hollerith punch code: 


Col, 


Col, 


Col. 
Col. 
Col. 
Col. 
Cot. 
Col, 
Col. 


land 2 


Sand 4 


Sto 10 
llto 12 
13 to 18 
19 to 20 
21 to 26 
27 and 28 
29 to 80 


97 


Connector number (in hexadecimal) of the disc unit on 
which the system's basic program file is mounted () 
00229> 

(same as cols, 3- 4) 

00209 > 

(same as cols. 3 - 4) 

coll o> 

(same as cols, 3 - 4) 


0016432001 0048 71.000000021040@044 01005046504 { 001500 
19 


b) For systems using the Bull punch code: 


Col. 
Col. 


land 2 
3and 4 


ZU 


Connector number (in hexadecimal) of the disc unit on 
which the system's basic program file is mounted (x) 


(# ) Following is a correspondence table for coded and pure hexadecimal values. 
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Col. 5to10 65520 


Col. 11 andi2 (sameas cols. 3 - 4) 


Col. 13 to 18 w¥5bZU 


Col. 19 and 20 §=(gameas cols. 3-4) 


Col. 21 to 26 BB6YZU 


Col. 27 and 28 = (same as cols, 3 - 4) 
Col. 29 to 80 Lbs W34 Shue bE34 TEHUB BUM SSK3KWH33K6KK2K31 2K3 YEK62KH6 Z 
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CORRESPONDING PURE HEXADECIMAL 


CODE HEXADECIMAL 


HUA Pore aAhroONWHO 


CODE HOLLERITH 


ODNMAMAWNE SD 


CODE BULL 


COP NARAAR 


Z (9-6) 
Y 9-5) 
x (9-4) 
WwW (9+3) 
V (9-2) 
U (9-1) 
T (9-0) 


Example: if the connection number of the dise unit containing the System 
Dise is 07 (coded hexadecimal) the punch will be 07 in the specified 
columns (using code Hollerith) or #0 (using code Bull). 
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. Please cut Q this line . 
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DOCUMENT REVIEW SHEET 


TITLE; GE-100 Line DOS Dise Operating System 


cope; 3916163 F_ / Réf, 32,38,003 A 
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